home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir38 / grabb397.zip / DOCFILES.SFX / GRABBER.DOC < prev    next >
Text File  |  1994-05-14  |  108KB  |  2,081 lines

  1.  
  2.  
  3.                               GRABBER(tm)   Version 3.97
  4.                                    Shareware Issue
  5.                                 ----------------------
  6.  
  7.                               The Screen Capture Program
  8.                           for MS-DOS and IBM PC Compatibles
  9.  
  10.  
  11.                           DOCUMENTATION AND TECHNICAL NOTES
  12.                                      May 14, 1994
  13.  
  14.                                 Copyright 1987-1994 by
  15.                                    Gerald A. Monroe
  16.                                  All rights reserved.
  17.  
  18.  
  19.                  +-------------------------------------------------+
  20.                  |  Although they are shareware, GRABBER and this  |
  21.                  |  documentation file are copyrighted.  They are  |
  22.                  |  not in the  public  domain  and they are  not  |
  23.                  |  "freeware."   Please  consult  page 6  of the  |
  24.                  |  REGISTER.DOC  file  for  important  copyright  |
  25.                  |  information and license provisions.            |
  26.                  +-------------------------------------------------+
  27.  
  28.                Thank you  for your interest in  the GRABBER(tm) screen
  29.                capture system!
  30.  
  31.                The GRABBER  package is being marketed  in this special
  32.                form as shareware.  This means you have the opportunity
  33.                to  use and evaluate it  for 30 days  before you decide
  34.                whether  to buy.   If you continue  to use GRABBER.EXE,
  35.                any of its  "offspring" programs, or  any of the  other
  36.                programs in  the  GRABBER package  beyond  such  30-day
  37.                period, then you are required to send your registration
  38.                fee to  the publisher according to  the instructions in
  39.                the  REGISTER.DOC file.   When  you register,  you will
  40.                receive a copy of the  latest release of the registered
  41.                GRABBER package that you  order.  You may  not continue
  42.                using GRABBER  beyond such 30-day period without regis-
  43.                tering.   For registration  instructions and a complete
  44.                statement of your license  to use this software, please
  45.                consult the REGISTER.DOC file.
  46.  
  47.                                 Gerald A. Monroe
  48.                                 P.O. Box 770906
  49.                                 Cleveland, Ohio 44107, U.S.A.
  50.                                 CompuServe Mail:  72321,1257
  51.                                 Fax:  (216) 521-6060
  52.  
  53.  
  54.           IBM  and PC  are  trademarks of  International Business  Machines
  55.           Corporation.   MS-DOS  and  Windows are  trademarks of  Microsoft
  56.           Corporation.    Hercules  is  a trademark  of  Hercules  Computer
  57.           Technology.   Other trademarks referenced herein  are the proper-
  58.           ties of their respective owners.
  59.  
  60.                                   Table of Contents
  61.  
  62.  
  63.           Shareware Registration and License Information . . . . . . . .  1
  64.  
  65.                         PART I:  CONFIGURING AND USING GRABBER
  66.  
  67.           Overview of GRABBER . . . . . . . . . . . . . . . . . . . . .   3
  68.           Hardware and DOS requirements . . . . . . . . . . . . . . . .   3
  69.           Kinds of screens that GRABBER can capture . . . . . . . . . .   3
  70.           Super-VGA graphics compatibility  . . . . . . . . . . . . . .   4
  71.           How to start GRABBER  . . . . . . . . . . . . . . . . . . . .   5
  72.           Capturing the screen  . . . . . . . . . . . . . . . . . . . .   5
  73.           The filename prompt function  . . . . . . . . . . . . . . . .   7
  74.           Special note for Hercules monochrome graphics users . . . . .   7
  75.           Capturing to a different drive/directory  . . . . . . . . . .   8
  76.           Configuring GRABBER for Super-VGA . . . . . . . . . . . . . .   8
  77.           Capturing from 8514/A-compatibles using GR4AI.EXE . . . . . .  10
  78.           Errors during the screen capture  . . . . . . . . . . . . . .  10
  79.           Tips on capturing from games  . . . . . . . . . . . . . . . .  11
  80.  
  81.           GRABBER configuration options . . . . . . . . . . . . . . . .  12
  82.                INT=nn . . . . . . . . . . . . . . . . . . . . . . . . .  13
  83.                INT=OFF  . . . . . . . . . . . . . . . . . . . . . . . .  13
  84.                PROMPT and NOPROMPT  . . . . . . . . . . . . . . . . . .  14
  85.                MOUSE and NOMOUSE  . . . . . . . . . . . . . . . . . . .  15
  86.                NOSWAP . . . . . . . . . . . . . . . . . . . . . . . . .  16
  87.                SOUND and NOSOUND  . . . . . . . . . . . . . . . . . . .  16
  88.                BATCHCAPTURE or BATCHCAPTURE:filename  . . . . . . . . .  16
  89.                NOEMS  . . . . . . . . . . . . . . . . . . . . . . . . .  17
  90.                NOUMB  . . . . . . . . . . . . . . . . . . . . . . . . .  18
  91.                UNLOAD . . . . . . . . . . . . . . . . . . . . . . . . .  18
  92.                DEFAULTDRIVE . . . . . . . . . . . . . . . . . . . . . .  19
  93.                NOVESA . . . . . . . . . . . . . . . . . . . . . . . . .  20
  94.  
  95.                  PART II:  USING GRABBER'S OFFSPRING .EXE IMAGE FILES
  96.  
  97.           Fade-in screen images:  "FADEIN"  . . . . . . . . . . . . . .  21
  98.           Fade-out screen images:  "FADEOUT"  . . . . . . . . . . . . .  21
  99.           Timed execution:  /Tn . . . . . . . . . . . . . . . . . . . .  22
  100.           Don't clear screen on exit: /F  . . . . . . . . . . . . . . .  23
  101.           Don't wait for any keypress: /N . . . . . . . . . . . . . . .  24
  102.           Keylist operation: /K . . . . . . . . . . . . . . . . . . . .  24
  103.           Sample batch file SHOWMENU.BAT  . . . . . . . . . . . . . . .  25
  104.  
  105.                          PART III:  MISCELLANEOUS INFORMATION
  106.  
  107.           Displaying Super-VGA graphics . . . . . . . . . . . . . . . .  28
  108.           Offspring file compatibility with other systems . . . . . . .  30
  109.           Using GRABBER with Microsoft Windows  . . . . . . . . . . . .  32
  110.           Changing GRABBER's hotkey . . . . . . . . . . . . . . . . . .  33
  111.           Testing the reliability of your VESA BIOS extension . . . . .  34
  112.           Calling GRABBER from your own programs  . . . . . . . . . . .  36
  113.           Reporting problems/bugs . . . . . . . . . . . . . . . . . . .  37
  114.  
  115.           APPENDIX A  (KEY=kk hotkey codes) . . . . . . . . . . . . . .  38
  116.           APPENDIX B  (SHIFT=ss hotkey codes) . . . . . . . . . . . . .  39
  117.  
  118.           GRABBER(tm)      Documentation & Technical Notes     Page 3 of 39
  119.  
  120.  
  121.  
  122.                         PART I:  CONFIGURING AND USING GRABBER
  123.  
  124.  
  125.           OVERVIEW OF GRABBER
  126.           --------------------
  127.  
  128.           GRABBER.EXE ("GRABBER") is a  screen-capture program for personal
  129.           computers using the MS-DOS  operating system.  GRABBER is  like a
  130.           camera focused on your computer screen.  It can take a picture of
  131.           practically any image on  the screen and save the  picture perma-
  132.           nently to  a disk file.   After  GRABBER takes a  picture of  the
  133.           screen, you can go back and redisplay the picture again, whenever
  134.           you want.  GRABBER  also comes with special  tools that let  your
  135.           other programs redisplay  the pictures, edit them, or  print them
  136.           out.
  137.  
  138.           GRABBER  has been around since 1987, and it is the most reliable,
  139.           most flexible, and most imitated software you will find  anywhere
  140.           for capturing  screens in  the MS-DOS environment,  regardless of
  141.           price.
  142.  
  143.  
  144.           HARDWARE AND DOS REQUIREMENTS
  145.           ------------------------------
  146.  
  147.           To use GRABBER, you will need:
  148.  
  149.                a)   an IBM PC, XT, AT, PS/2, or 100% compatible computer;
  150.                b)   at least one floppy diskette drive; and
  151.                c)   MS-DOS, or IBM PC-DOS, Version 3.0 or later.
  152.  
  153.           You  can use GRABBER with either  a color or a monochrome display
  154.           screen.
  155.  
  156.  
  157.           KINDS OF SCREENS THAT GRABBER CAN CAPTURE
  158.           ------------------------------------------
  159.  
  160.           GRABBER  is designed to capture screens from programs that run in
  161.           "real  mode" or "virtual 8086"  mode under MS-DOS.   GRABBER cap-
  162.           tures character-based text images  up to 132 columns by  60 rows.
  163.           GRABBER also  captures many  "standard" types of  graphic images.
  164.           The following chart details all of the standard video modes which
  165.           GRABBER is designed to work with:
  166.  
  167.           Mode    Type         X/Y Image         No. of   Adapters which
  168.            No.   of Mode       Resolution        Colors   support mode
  169.           -----  --------  --------------------  ------  ----------------
  170.            00      text      40 x 25 characters     2    CGA MCGA EGA VGA
  171.            01      text      40 x 25 characters    16    CGA MCGA EGA VGA
  172.            02      text    80+ x 25+ characters     2    CGA MCGA EGA VGA
  173.            03      text    80+ x 25+ characters    16    CGA MCGA EGA VGA
  174.            07      text    80+ x 25+ characters     2    MGA MCGA EGA VGA
  175.  
  176.           GRABBER(tm)      Documentation & Technical Notes     Page 4 of 39
  177.  
  178.  
  179.  
  180.           Mode    Type         X/Y Image         No. of   Adapters which
  181.            No.   of Mode       Resolution        Colors   support mode
  182.           -----  --------  --------------------  ------  ----------------
  183.  
  184.            04    graphics      320 x 200 pixels     4    CGA MCGA EGA VGA
  185.            05    graphics      320 x 200 pixels     2    CGA MCGA EGA VGA
  186.            06    graphics      640 x 200 pixels     2    CGA MCGA EGA VGA
  187.            07+   graphics      720 x 348 pixels     2    MGA (Hercules)
  188.  
  189.            13    graphics      320 x 200 pixels    16    EGA VGA
  190.            14    graphics      640 x 200 pixels    16    EGA VGA
  191.            15    graphics      640 x 350 pixels     2    EGA VGA
  192.            16    graphics      640 x 350 pixels    16    EGA VGA
  193.            17    graphics      640 x 480 pixels     2    VGA MCGA
  194.            18    graphics      640 x 480 pixels    16    VGA
  195.            19    graphics      320 x 200 pixels   256    VGA MCGA
  196.  
  197.           Note:   Some programs use special graphics screen modes which are
  198.           based on one of the above EGA/VGA "standard" modes, but which are
  199.           altered for increased resolution or color depth by making special
  200.           adjustments to the video adapter registers.  Examples include the
  201.           320 x  240 x 256-color  mode and the  720 x 540 x  16-color mode.
  202.           Use  GRPCX.EXE instead  of GRABBER.EXE  to capture  these special
  203.           types  of screens.  (GRPCX.EXE is included  in this package.  See
  204.           GRPCX.DOC for more information.)
  205.  
  206.  
  207.           SUPER-VGA GRAPHICS COMPATIBILITY
  208.           ---------------------------------
  209.  
  210.           In addition to the modes above, GRABBER can capture the following
  211.           high-resolution graphic  modes under MS-DOS, on  systems that are
  212.           equipped with certain brands of "Super-VGA" graphics adapters:
  213.  
  214.                * 16-color modes:   800 x 16; 1024 x 768
  215.                * 256-color modes:  640 x 400; 640 x 480; 800 x 600;
  216.                                    1024 x 768; (VESA only: 1280 x 1024)
  217.  
  218.           GRABBER can capture these high-resolution modes if your system is
  219.           equipped  with a video adapter that was manufactured using one of
  220.           several  popular types of  Super-VGA controller chips.   In addi-
  221.           tion, GRABBER  is compatible  with these  modes on any  Super-VGA
  222.           adapter which fully supports the VESA video BIOS extension.
  223.  
  224.           If you want to  capture Super-VGA graphics, and your  system does
  225.           not  support the VESA software  standard (or your  VESA driver is
  226.           not loaded in  memory), then you must tell GRABBER  which kind of
  227.           video adapter is installed in your system.  To check whether your
  228.           current configuration  supports the  VESA software  standard, use
  229.           the CHKVBE.EXE program described below on page 34.  If CHKVBE.EXE
  230.           reports that the VESA  standard is not available in  your current
  231.           configuration,  see  page 8  below  for  instructions on  how  to
  232.           configure GRABBER for your particular type of Super-VGA hardware.
  233.  
  234.           GRABBER(tm)      Documentation & Technical Notes     Page 5 of 39
  235.  
  236.  
  237.  
  238.           HOW TO START GRABBER
  239.           ---------------------
  240.  
  241.           Before GRABBER can start capturing your screen images, it must be
  242.           installed  in your  computer's memory,  or  be made  "resident in
  243.           memory."
  244.  
  245.           To install GRABBER  in memory, enter a command at  the DOS prompt
  246.           which follows one of these formats:
  247.  
  248.                (1)  GRABBER drive:\pathname       >> for hard-disk systems
  249.  
  250.                (2)  GRABBER drive:                >> for two-floppy systems
  251.  
  252.                (3)  GRABBER DEFAULTDRIVE          >> for one-floppy systems
  253.  
  254.  
  255.           In the first  and second examples, [drive] can be a single letter
  256.           for  any valid disk drive  name in your system, from  A to Z.  If
  257.           your system has  a hard disk drive,  you should follow the  first
  258.           example.   [Pathname] in the first example represents the name of
  259.           an existing directory on your hard disk where you want GRABBER to
  260.           deposit the offspring image files that you ask it to create.
  261.  
  262.           If you  have two  floppy diskette  drives and  no hard  disk, you
  263.           should follow the second command example.  You can specify either
  264.           A: or B:  for the [drive:]  parameter.  Offspring  files will  be
  265.           placed on  the diskette that is  in the drive you  specify.  (You
  266.           may also use the second example if you have a hard-disk system.)
  267.  
  268.           Follow  the third  command example  if you  have only  one floppy
  269.           diskette  drive  and no  hard  drive.    "DEFAULTDRIVE" does  not
  270.           represent some other  parameter which you  supply; type the  word
  271.           DEFAULTDRIVE itself on  the command line after  the word GRABBER.
  272.           Offspring files will  be placed  on the diskette  in your  single
  273.           drive.
  274.  
  275.           Please note that GRABBER  will not stay resident in  memory until
  276.           you have told it where to place its offspring files, according to
  277.           one of the examples above.
  278.  
  279.           You  may also start GRABBER by including  a line in a batch file,
  280.           such as your AUTOEXEC.BAT startup file.  The line  you include in
  281.           a batch file is the same  as the command line you would enter  on
  282.           your keyboard to start GRABBER at the DOS prompt.
  283.  
  284.  
  285.           CAPTURING THE SCREEN
  286.           ---------------------
  287.  
  288.           When you install GRABBER  in memory, the program displays  a blue
  289.           welcome banner  on your  screen in  the upper  left corner.   The
  290.           banner means  that GRABBER  is successfully installed  in memory.
  291.  
  292.           GRABBER(tm)      Documentation & Technical Notes     Page 6 of 39
  293.  
  294.  
  295.  
  296.           (The display also contains some other useful information, such as
  297.           your current hotkey combination,  the drive/path to which screens
  298.           will be captured, and how much memory GRABBER is occupying.)  You
  299.           are now ready to capture display screens to disk.
  300.  
  301.           To capture the  screen, you press GRABBER's reserved key combina-
  302.           tion, which is [CTRL =].  That is, you hold down the [CTRL]  key,
  303.           press the equal sign key [=],  then release the [CTRL] key again.
  304.           From now on, this  key sequence will be referred to  as GRABBER's
  305.           "hotkey" combination.
  306.  
  307.           If you  want to, you can  change the hotkey  combination to some-
  308.           thing else.  See page 33 below for instructions.
  309.  
  310.           The quickest way to test GRABBER is from your DOS  prompt.  Enter
  311.           these three commands in this order:
  312.  
  313.                                         CLS
  314.                                         DIR /W
  315.  
  316.           This will  clear your screen  and fill it again  with a directory
  317.           listing of the current drive and  path.  Now, press [CTRL =]. You
  318.           hear a soft beep,  and a prompt  appears on the  top line of  the
  319.           display, showing a default  file name to which  you may save  the
  320.           current screen.   If  you wish  to accept  the default  file name
  321.           which  GRABBER is providing, just  press <Enter>. If  you want to
  322.           type  in your own  file name,  you may  do so.   After  you press
  323.           <Enter>, the prompt disappears  and GRABBER immediately begins to
  324.           create the offspring  file on the correct drive.  When GRABBER is
  325.           finished  capturing the  screen, you  hear an  ascending two-tone
  326.           chirp.
  327.  
  328.           Now, you are ready to display the screen you have just  captured.
  329.           It is a program file, ready  to be executed just like GRABBER it-
  330.           self.  Go to the drive and directory where it  was placed (if you
  331.           are not already there), and enter this command at the DOS prompt:
  332.  
  333.                                        MSDOS00
  334.  
  335.           (or whatever you  named your offspring file.)   What you  see are
  336.           the contents  of the  screen you  created a  moment ago  when you
  337.           pressed  [CTRL =].    This image  is  contained within  the  file
  338.           MSDOS00.EXE, a GRABBER offspring.   The image will remain  on the
  339.           screen until you press  a key -- almost any key --  to make it go
  340.           away.   The screen then erases itself  and you are back where you
  341.           started, at the DOS prompt.
  342.  
  343.           When  you  press  [CTRL =]  again,  GRABBER  will create  another
  344.           offspring  containing the current screen.   If you  do not supply
  345.           your   own  file  name,  it  will  be  called  MSDOS01.EXE,  then
  346.           MSDOS02.EXE,  and so  forth, up  to MSDOS99.EXE.   Each  of these
  347.           offspring  programs can  be executed  just the  same way  as your
  348.  
  349.           GRABBER(tm)      Documentation & Technical Notes     Page 7 of 39
  350.  
  351.  
  352.  
  353.           MSDOS00.EXE, either  from the keyboard at the DOS prompt, or as a
  354.           line in a batch file.
  355.  
  356.           Your computer does  not have to be sitting at  the DOS prompt, as
  357.           it was in  the example above, for  you to capture a screen.   You
  358.           can use GRABBER to capture screens from thousands of different PC
  359.           application programs.
  360.  
  361.  
  362.           THE FILENAME PROMPT FUNCTION
  363.           -----------------------------
  364.  
  365.           Here are  some things you  should know  about GRABBER's  filename
  366.           prompts:
  367.  
  368.           You  cannot  change the  drive or  directory  path to  which your
  369.           screen will  be saved by entering a  new one at the  prompt.  All
  370.           you  may  supply  is  a valid  one-character  to  eight-character
  371.           filename, using  characters DOS regards as  "legal" for filenames
  372.           (i.e., no blank spaces, control  characters, wildcards, etc.)  If
  373.           you enter  a file name  that is less than  eight characters long,
  374.           GRABBER will ignore the blank spaces between the end of the  file
  375.           name and the start of the ".EXE" extension.
  376.  
  377.           You cannot  change the file  name extension  at the prompt.   The
  378.           extension  of any offspring file  must remain ".EXE"  so that DOS
  379.           will recognize the file as an executable program and allow you to
  380.           view the image later.
  381.  
  382.           All images are saved to the drive and/or directory path which you
  383.           specified when  you installed  GRABBER according to  the instruc-
  384.           tions on page 5, above.   If you want to change  the drive and/or
  385.           directory  path to which your images are  saved, you may do so by
  386.           issuing another GRABBER command at  the DOS prompt -- see  page 8
  387.           below.
  388.  
  389.           If  you want to  cancel the screen capture  operation at the file
  390.           name  prompt, just  press <Esc>  once or  twice until  the prompt
  391.           disappears.  If you make a typing mistake while entering the file
  392.           name at the prompt, use the backspace key to correct the mistake.
  393.  
  394.           For more information about the filename prompt function, refer to
  395.           the section  below called  "GRABBER Installation Options."   That
  396.           section also includes instructions for enabling and disabling the
  397.           filename prompt function.
  398.  
  399.  
  400.           SPECIAL NOTE FOR HERCULES-COMPATIBLE GRAPHICS USERS
  401.           ----------------------------------------------------
  402.  
  403.           When operating  in the 720x348 graphic  mode, Hercules-compatible
  404.           monochrome  graphic adapters  divide  the video  memory into  two
  405.           segments commonly known as Page 0 and Page 1.  These adapters can
  406.  
  407.           GRABBER(tm)      Documentation & Technical Notes     Page 8 of 39
  408.  
  409.  
  410.  
  411.           display a  graphic image on either  of these two  pages, but only
  412.           one  page at  a time  may be  displayed  on the  screen.   Due to
  413.           certain  technical  limitations  in  the  architecture  of  these
  414.           adapters, it is not possible to determine with certainty which of
  415.           these two  pages, Page 0  or Page  1, is being  displayed at  any
  416.           given time.
  417.  
  418.           Rather than risking  an incorrect guess as to which  of these two
  419.           pages  is currently  being displayed, (which  would result  in an
  420.           offspring file containing only  a blank or garbage-filled image),
  421.           GRABBER requires you to choose which page to capture.  After  you
  422.           press GRABBER's hotkey while  in the graphic mode, you  will hear
  423.           one short beep.   GRABBER  is waiting for  you to indicate  which
  424.           page you wish to capture.  To choose the  lower Page 0, press the
  425.           [0] key.  To choose the higher Page 1, press the [1] key.  If you
  426.           press anything other than [0] or [1], you will cancel  the screen
  427.           capture request and return to the foreground application.
  428.  
  429.           There are  two ways for  you to determine,  if you are  not sure,
  430.           whether the monochrome graphic image is being displayed on Page 0
  431.           or Page 1. The first way is to consult the  documentation for the
  432.           application  program which is generating  the image to  see if it
  433.           mentions this.   (Some applications in  their installation proce-
  434.           dures allow you to force the use of one or the  other page.)  The
  435.           second way is by trial and error.  If you choose to  capture Page
  436.           0 but the resulting offspring file is not what you expected, this
  437.           indicates  that you  should  select  Page  1 to  capture  720x348
  438.           graphic images generated by that application program.
  439.  
  440.  
  441.           CAPTURING TO A DIFFERENT DRIVE/DIRECTORY
  442.           -----------------------------------------
  443.  
  444.           If  you first installed GRABBER to capture offspring files to one
  445.           drive or directory, and you later want to switch to another drive
  446.           or directory (or use DEFAULTDRIVE), you can simply issue  another
  447.           GRABBER command at the DOS  prompt as described above on page  5.
  448.           GRABBER  will  display  a  screen of  status  information,  which
  449.           informs you that the new destination is now in effect.
  450.  
  451.  
  452.           CONFIGURING GRABBER FOR SUPER-VGA
  453.           ----------------------------------
  454.  
  455.           Before GRABBER  is  able  to  capture  high-resolution  Super-VGA
  456.           images,  you  must tell  the program  which  type of  VGA chipset
  457.           circuitry is used by your adapter.
  458.  
  459.           (If you have  a Super-VGA  adapter that fully  supports the  VESA
  460.           video BIOS extension, you should not need to configure GRABBER to
  461.           capture your  high-resolution Super-VGA images.   However, if you
  462.           experience problems capturing such images with your VESA-compati-
  463.           ble system, the following procedure may solve the problems.)
  464.  
  465.           GRABBER(tm)      Documentation & Technical Notes     Page 9 of 39
  466.  
  467.  
  468.  
  469.           To  configure GRABBER  for  your Super-VGA,  include  one of  the
  470.           following "@" parameters on GRABBER's command line.  For example:
  471.  
  472.                           GRABBER [other options] @CHIPTYPE
  473.  
  474.           Here are the VGA chipset names which GRABBER recognizes.  Use one
  475.           of these in place of "@chiptype" in the example above.
  476.  
  477.  
  478.           @ATI           ATI Technologies chips
  479.           @VIDEO7        Video Seven chips
  480.           @HEADLAND      Headland Technology chips
  481.           @PARADISE      Paradise PVGA chips
  482.           @WD            Western Digital WD90C00 chips
  483.           @TSENG3        Tseng Laboratories ET-3000 chip
  484.           @TSENG4        Tseng Laboratories ET-4000 chip
  485.           @STB4          STB adapters using the Tseng Labs ET-4000 chip
  486.           @AHEADA        Ahead Systems chip version "A"
  487.           @AHEADB        Ahead Systems chip version "B"
  488.           @GENOA         Genoa GVGA chip (used by 6000 series cards)
  489.           @OAK           Oak Technology OTI-067 chip
  490.           @TRIDENT       Trident chips
  491.           @NCR           NCR 77C22E chip
  492.  
  493.  
  494.           In many cases, but not all, the chipset names here will match the
  495.           brand name of  the adapter.   For example, almost all  ATI, Video
  496.           Seven and  Trident brand-name  adapters use chipsets  which carry
  497.           the board manufacturer's own name.  However, you should note that
  498.           this  is not  always  true.   Very  many Super-VGA  adapters  use
  499.           chipsets that  were  manufactured  by  a source  other  than  the
  500.           company whose brand name  is on the product.   Such manufacturers
  501.           (for example:   STB, Orchid,  Genoa and Everex)  have not  always
  502.           produced their own VGA chipsets.  Instead, they have built Super-
  503.           VGA adapters using chipsets from other sources, and have marketed
  504.           the finished products under their own brand names.
  505.  
  506.           Therefore, if  you are  not  sure which  type of  VGA chipset  is
  507.           employed by your Super-VGA adapter, you  should determine this by
  508.           examining the Super-VGA itself, and looking for the  name printed
  509.           on  top of the VGA logic chip.  (Usually, the Super-VGA is a card
  510.           in one of your computer's expansion slots,  but sometimes it is a
  511.           section of the main system board itself.)
  512.  
  513.           The other  way to determine which of  these GRABBER configuration
  514.           settings will work for you is by trial-and-error.  If one setting
  515.           does not work  properly, try the next setting in  the above list.
  516.           (You  can  issue successive  "@chiptype"  commands  from the  DOS
  517.           prompt,  without removing  GRABBER from  memory and  reinstalling
  518.           it.)
  519.  
  520.           If you attempt to capture a  Super-VGA graphic image and hear one
  521.           single low-pitched beep, it means that GRABBER does not recognize
  522.  
  523.           GRABBER(tm)      Documentation & Technical Notes    Page 10 of 39
  524.  
  525.  
  526.  
  527.           or  is not  configured to  capture the  specific display  mode in
  528.           which  the adapter is currently operating.  This will happen with
  529.           Super-VGA graphics  if your video system  is not VESA-compatible,
  530.           and you have not configured  GRABBER for the correct type of  VGA
  531.           chipset.
  532.  
  533.           You should  also note that  GRABBER cannot capture  some 16-color
  534.           Super-VGA  images even  though  they are  of common  resolutions.
  535.           Typical examples are ATI's video mode numbered 65h (used for 1024
  536.           x 768 x 16  on older VGA Wonder cards),  and the 1024 x 768  x 16
  537.           and  800 x 600 x 16 modes on adapters, such as some models of the
  538.           Diamond Stealth and Orchid  Fahrenheit adapters, which employ the
  539.           S-Cubed 86C911 chipset (a chip not supported directly  by GRABBER
  540.           but possibly by way of a VESA driver).  GRABBER only captures 16-
  541.           color modes which conform to the IBM-standard "four-plane planar"
  542.           memory  organization scheme such as that used by the standard 640
  543.           x 350  x 16 EGA graphic mode.   Modes such as  the ones mentioned
  544.           above  do not conform to  the standard memory  layout scheme, but
  545.           use memory  layouts unique to the  particular board manufacturer.
  546.           Therefore, they and  similar modes cannot be  captured by GRABBER
  547.           -- but  they might be able  to be captured by  GR4AI.EXE.  Fortu-
  548.           nately, such modes are rare.
  549.  
  550.  
  551.           CAPTURING FROM 8514/A-COMPATIBLES USING GR4AI.EXE
  552.           --------------------------------------------------
  553.  
  554.           The 8514/A Adapter Interface (AI) is a video standard invented by
  555.           IBM which  is now  increasingly being  recognized by  other video
  556.           manufacturers.  Although 8514/A supports the common 640 x 480 and
  557.           1024 x  768  image  resolutions,  it is  a  completely  different
  558.           standard than VGA or Super-VGA.
  559.  
  560.           There are  several types of  VGA chipsets which  GRABBER.EXE does
  561.           not  directly support  in  high-resolution Super-VGA  modes.   An
  562.           example is the S-Cubed 86C911 chip, used by recent  "accelerator"
  563.           boards  marketed by Diamond, Orchid  and Genoa.   However, if you
  564.           have such an adapter and its manufacturer also supplies a memory-
  565.           resident (TSR) program  that allows  the board  to be  compatible
  566.           with the 8514/A  AI (and thus "emulate" a true 8514/A card), then
  567.           you can capture  high-resolution 640 x 480 and 1024  x 768 images
  568.           from  the adapter by using the GR4AI.EXE program included in this
  569.           GRABBER package.   Consult the GR4AI documentation  file for more
  570.           information.
  571.  
  572.  
  573.           ERRORS DURING THE SCREEN CAPTURE
  574.           ---------------------------------
  575.  
  576.           If  GRABBER is  unable to  capture your  image because  it cannot
  577.           recognize the current  video mode,  then it will  make one  short
  578.           low-pitched beep sound  on your  PC's speaker.   (See pages  9-10
  579.           above.)
  580.  
  581.           GRABBER(tm)      Documentation & Technical Notes    Page 11 of 39
  582.  
  583.  
  584.  
  585.           If GRABBER is unable to  capture your image for any  reason other
  586.           than an unrecognized video  mode, it will sound three  short low-
  587.           pitched beeps on your speaker.  If you hear this signal, it means
  588.           the  screen has  not  been captured,  probably  because there  is
  589.           something wrong with  the disk you  are trying to capture  it to.
  590.           Correct the condition with  your disk, and use the  hotkey to try
  591.           the capture again.
  592.  
  593.           Usually, these errors are  fairly obvious to detect:   you forget
  594.           to put  a diskette in the disk drive, or you leave the drive door
  595.           open, or the diskette is  write-protected.  Some errors, however,
  596.           are not  so obvious to the eye.  GRABBER  will also beep if:  (1)
  597.           the disk to which you are trying to capture the screen is already
  598.           full;  (2) its directory area cannot fit anymore entries; (3) the
  599.           FILES= command in  your CONFIG.SYS file  does not specify  enough
  600.           files; (4) there is a physical  defect on the disk itself; or (5)
  601.           after installing  GRABBER in memory, you  deleted the GRABBER.EXE
  602.           file or moved it to another location.
  603.  
  604.           After installing  GRABBER in  memory, *do  not* delete  the GRAB-
  605.           BER.EXE  file  or  move it  to  another  location  on your  disk.
  606.           GRABBER will be disabled  until you uninstall it (see  below) and
  607.           re-install it, or until you move the GRABBER.EXE file back to the
  608.           drive  and  directory where  it  was located  when  you initially
  609.           installed it in memory.
  610.  
  611.  
  612.           TIPS ON CAPTURING FROM GAMES
  613.           ------------------------------
  614.  
  615.           Game programs, especially  those which generate  animated graphic
  616.           screens, are some  of the  most challenging types  of screens  to
  617.           capture reliably.  You may find a game program from which GRABBER
  618.           seems unable to capture accurate  offspring images, or any images
  619.           at  all.   Here  are some  suggestions  that may  help  solve the
  620.           problem:
  621.  
  622.                *    Some games  use non-standard  video  modes which  GRAB-
  623.           BER.EXE cannot capture correctly, but which GRPCX.EXE can capture
  624.           with no problems.  A common  symptom of this is an .EXE offspring
  625.           file which looks scrambled, or duplicates a miniature form of the
  626.           image several times across  the screen, or is totally empty.   If
  627.           you have a VGA-compatible system, try using the GRPCX.EXE utility
  628.           supplied with this package.
  629.  
  630.                *    If  possible,  capture   screens  on  a  VGA-compatible
  631.           system.  Usually,  it is  easier for GRABBER  to capture  screens
  632.           from VGA-compatible systems than it is from EGA systems.
  633.  
  634.                *    In some  games, GRABBER's filename  prompts will  leave
  635.           behind  garbage on the screen, or cause improper operation of the
  636.           game after the prompt is cleared.  Try using the NOPROMPT option,
  637.           which is described below on page 14.
  638.  
  639.           GRABBER(tm)      Documentation & Technical Notes    Page 12 of 39
  640.  
  641.  
  642.  
  643.                *    Some games require complete control over the  keyboard,
  644.           and  will not let you use the  keyboard to communicate with GRAB-
  645.           BER.   Make sure that you  do not use the  "INT=OFF" command-line
  646.           switch when you initially  load GRABBER in memory.   If "INT=OFF"
  647.           is not  being used and you still  cannot capture the screen using
  648.           your keyboard, try using your mouse buttons to capture the screen
  649.           instead.  See  the MOUSE option, which is described below on page
  650.           15.
  651.  
  652.                *    You may  have to try  more than once to  capture a game
  653.           screen  successfully.  If a  game screen turns  out scrambled, it
  654.           may be because the game  was in the middle of  a timing-sensitive
  655.           operation at the instant you called GRABBER.
  656.  
  657.  
  658.           GRABBER CONFIGURATION OPTIONS
  659.           ------------------------------
  660.  
  661.           This section identifies the "command line switches" which GRABBER
  662.           recognizes and responds to.  A command line switch is a string of
  663.           characters  which  you type  after  the  GRABBER command  itself,
  664.           whether  you are calling GRABBER directly from the DOS prompt, or
  665.           from a line in a batch file.
  666.  
  667.           These  switches allow  you  to modify  the  way GRABBER  performs
  668.           certain operations.   For example, turning  GRABBER's beep sounds
  669.           on and off,  or enabling GRABBER's  use of the  mouse buttons  to
  670.           capture  the screen,  are just  two of  the many  functions which
  671.           GRABBER's command line switches allow you to control.
  672.  
  673.           All of the command line switches described in this section may be
  674.           used to configure GRABBER's operations when you initially install
  675.           the  program in memory.  In addition, after GRABBER is installed,
  676.           you may continue  to use  most of these  switches to  communicate
  677.           with  the copy of GRABBER that is  resident in memory, and recon-
  678.           figure its operations, "on the fly."
  679.  
  680.           Unless the description of a command line switch states otherwise,
  681.           that switch may be  used both when you initially  install GRABBER
  682.           in  memory, and  to  reconfigure GRABBER's  operations after  the
  683.           program is made  resident.  If a particular switch  is valid only
  684.           when  you initially  load GRABBER  in memory,  that fact  will be
  685.           indicated below.
  686.  
  687.           A single command line may  contain as many switch options  as you
  688.           desire, in any order, in either uppercase or lowercase letters.
  689.  
  690.           GRABBER(tm)      Documentation & Technical Notes    Page 13 of 39
  691.  
  692.  
  693.  
  694.           Option:   INT=nn
  695.  
  696.           Usage:    GRABBER [other options] INT=nn
  697.  
  698.           This switch tells GRABBER to attempt to use a particular block of
  699.           interrupt  vector numbers for  relocating the  IRQ0-IRQ7 hardware
  700.           interrupts while GRABBER  is resident in memory.  The 'nn' in the
  701.           string represents  a two-digit  hexadecimal number, which  may be
  702.           any one of  the following:  D8,  D0, C8, C0, B8, B0,  A8, A0, 98,
  703.           90, 88, 80, or 78.  GRABBER will attempt to use the eight consec-
  704.           utive  interrupt vector  numbers  beginning with  the number  you
  705.           specify as  'nn'.   (For example:   INT=78 tells  GRABBER to  try
  706.           allocating interrupts  78 hex through  7F hex,  while INT=B0  in-
  707.           structs  GRABBER to try  allocating interrupts B0  hex through B7
  708.           hex.)
  709.  
  710.           GRABBER  will ignore your  INT=nn request, and  will not redirect
  711.           the  IRQ0-IRQ7 hardware  interrupts  at  all,  if either  of  the
  712.           following  is true:    (1) the  'nn' number  you  specify is  not
  713.           included  in the list above; or (2) GRABBER detects a possibility
  714.           that one  or more of  the eight  interrupt numbers  in the  block
  715.           starting with 'nn' might already be in use by some other software
  716.           in your system.
  717.  
  718.           If you do  not specify the INT=nn option, and  you do not specify
  719.           the "INT=OFF"  option (described below), then  GRABBER will auto-
  720.           matically  search for  a  block of  eight consecutive  interrupts
  721.           beginning with one  of the  interrupt numbers in  the above  list
  722.           (searching  in the  order listed  above), and  will allocate  the
  723.           first free block it finds.
  724.  
  725.           The INT=nn option is valid only when you are initially installing
  726.           GRABBER in  memory.   If  you  use it  after  GRABBER is  already
  727.           resident, it will be ignored.
  728.  
  729.           For  more information  about  GRABBER's redirection  of  hardware
  730.           interrupts IRQ0-IRQ7, see the "INT=OFF" option (described below).
  731.  
  732.  
  733.           Option:   INT=OFF
  734.  
  735.           Usage:    GRABBER [other options] INT=OFF
  736.  
  737.           This  switch tells GRABBER not  to attempt to  redirect the IRQ0-
  738.           IRQ7 hardware interrupts to any other block of interrupt  numbers
  739.           from  where GRABBER  originally finds  them.   On most  PC's, the
  740.           IRQ0-IRQ7  hardware interrupts  are almost  always mapped  to the
  741.           interrupt  vector numbers  08  hex through  0F  hex.   Using  the
  742.           INT=OFF  option ensures that GRABBER will  not attempt to disturb
  743.           this mapping arrangement.
  744.  
  745.           If  your system  begins  to crash  for  no apparent  reason  when
  746.           GRABBER is loaded  in memory, you  should first  try to use  this
  747.  
  748.           GRABBER(tm)      Documentation & Technical Notes    Page 14 of 39
  749.  
  750.  
  751.  
  752.           INT=OFF option on the command line.  Note that the INT=OFF option
  753.           is  valid  only when  you  are  initially installing  GRABBER  in
  754.           memory.  If you use it after GRABBER is already resident, it will
  755.           be ignored.
  756.  
  757.           For more information about GRABBER's redirection of the IRQ0-IRQ7
  758.           hardware interrupts, see the  "INT=nn" option (described above on
  759.           page 13).
  760.  
  761.  
  762.  
  763.           Option:   PROMPT  and  NOPROMPT
  764.  
  765.           Usage:    GRABBER [other options] PROMPT
  766.                     GRABBER [other options] NOPROMPT
  767.  
  768.           These  switches tell GRABBER whether  you wish to  be prompted on
  769.           the  screen to  enter a  name for  each .exe  image before  it is
  770.           created, or instead, whether  each .exe file should automatically
  771.           be assigned a  name by  GRABBER.   The default  setting for  this
  772.           option is PROMPT  (i.e., prompts enabled).   The command  GRABBER
  773.           NOPROMPT can  be used to  turn off the  prompts.  They  will then
  774.           remain disabled until the next GRABBER PROMPT command is issued.
  775.  
  776.           While the filename prompt function is disabled, GRABBER automati-
  777.           cally assigns a name to each .exe image file it creates.  GRABBER
  778.           tries to automatically  detect the  name of the  program that  is
  779.           running when  you tell it to  capture the screen.   If GRABBER is
  780.           able to detect the program's name, it takes the first six charac-
  781.           ters of that  name and adds:   (i) a  two-digit number from  "00"
  782.           through "99", and (ii) a file  name extension of ".EXE".  This is
  783.           the name that will be assigned to the captured screen file.
  784.  
  785.           GRABBER always picks the lowest available two-digit number in the
  786.           destination  path.   For example,  if you  are running  a program
  787.           called  "WORDPROC.EXE" and  there are already  four files  in the
  788.           destination  path  named  "WORDPR00.EXE" through  "WORDPR03.EXE",
  789.           then  your next screen capture  from that program  will be called
  790.           "WORDPR04.EXE".  If there  are already 100 files in  the destina-
  791.           tion path  named "WORDPR00.EXE" through "WORDPR99.EXE", then your
  792.           next   screen  capture   from   that  program   will  be   called
  793.           "WORDPR00.EXE",  and the  contents of  the original  WORDPR00.EXE
  794.           file will be overwritten and lost forever.
  795.  
  796.           If GRABBER  detects that you are  sitting at the  DOS prompt when
  797.           you request a  screen capture,  it will name  the captured  files
  798.           MSDOS00.EXE, MSDOS01.EXE, and so forth.
  799.  
  800.           If GRABBER is unable to detect the name of the  currently running
  801.           program, it will assign the names SCREEN00.EXE, SCREEN01.EXE, and
  802.           so forth.
  803.  
  804.           GRABBER(tm)      Documentation & Technical Notes    Page 15 of 39
  805.  
  806.  
  807.  
  808.           Hercules monochrome graphics users:   Please note that the  file-
  809.           name prompt function is not available at all when you are captur-
  810.           ing 720 x 348  monochrome graphic images, even though  the prompt
  811.           function may  be enabled  when you are  capturing character-based
  812.           text  screens.  When GRABBER  senses  such  a  graphic image,  it
  813.           automatically  assigns a file name  to the .exe  file it creates,
  814.           based on the above scheme.
  815.  
  816.           EGA, VGA and Super-VGA users:  Some foreground applications which
  817.           operate in graphic modes  can be very sensitive to  interruptions
  818.           by underlying memory-resident programs  like GRABBER.  Because of
  819.           this, your filename prompts  may sometimes appear in  a distorted
  820.           form on your screen when the display is running in a high-resolu-
  821.           tion graphic  mode.  There is no way to predict when such distor-
  822.           tion  might occur, and  nothing can  be done  about it  except to
  823.           temporarily  disable  GRABBER's filename  prompts.    So, if  the
  824.           prompts  cause unacceptable  side effects  on a  particular fore-
  825.           ground  program, you  should issue  the command  GRABBER NOPROMPT
  826.           before  trying  to  capture  screens from  inside  that  program.
  827.           Please  note that even though  a filename prompt  may appear dis-
  828.           torted,  GRABBER is not aware  of the distortion  and still waits
  829.           for you  to enter  a filename  at the keyboard  or to  cancel the
  830.           operation by pressing <Esc>.
  831.  
  832.  
  833.           Option:   MOUSE  and  NOMOUSE
  834.  
  835.           Usage:    GRABBER [other options] MOUSE
  836.                     GRABBER [other options] NOMOUSE
  837.  
  838.           The MOUSE switch tells GRABBER to pay  attention to the status of
  839.           your mouse buttons, and to capture the screen when  both the left
  840.           and right buttons are  depressed for more than about  one second.
  841.           This "mouse hotkey" function  is supported only if your  mouse is
  842.           running under the control of a Microsoft-compatible mouse driver,
  843.           as most mice do.  The default setting for this  option is NOMOUSE
  844.           (i.e., no mouse support).  The command GRABBER  MOUSE can be used
  845.           to turn it on.   The mouse hotkey will then remain  enabled until
  846.           the command GRABBER NOMOUSE is issued.
  847.  
  848.           To capture a screen, press and hold both the left and right mouse
  849.           buttons  for about one or two seconds.   This has the same effect
  850.           as pressing  GRABBER's usual hotkey combination  at the keyboard,
  851.           and the filename prompt will appear at the top of the screen.  If
  852.           you wish, you may now use the keyboard  to enter a filename.  You
  853.           may also use the mouse buttons to proceed with the screen capture
  854.           or  to  cancel. The  left button  acts in  the  same way  as your
  855.           keyboard's <Enter> key, and the right button acts like your <Esc>
  856.           key.
  857.  
  858.           When  used  together with  the  INT=OFF option  (see  pages 13-14
  859.           above),  the MOUSE option may  allow you to  capture screens from
  860.           within  applications  which  completely  take over  the  keyboard
  861.  
  862.           GRABBER(tm)      Documentation & Technical Notes    Page 16 of 39
  863.  
  864.  
  865.  
  866.           hardware and allow no software loaded before them in memory (such
  867.           as  GRABBER)  to be  informed about  events  taking place  at the
  868.           keyboard.  Many game programs behave this way, among others.
  869.  
  870.  
  871.           Option:   NOSWAP
  872.  
  873.           Usage:    GRABBER [other options] NOSWAP
  874.  
  875.           This  switch tells GRABBER not  to attempt to  "swap" certain key
  876.           regions  of the  MS-DOS  kernel out  of  memory during  a  screen
  877.           capture operation.
  878.  
  879.           By  default, GRABBER will  perform this swapping  during a screen
  880.           capture  operation in order to reduce the delays between the time
  881.           you  press  GRABBER's hotkey  combination  and  the time  GRABBER
  882.           actually begins capturing the screen  image.  On rare  occasions,
  883.           however, with some systems and with some software, this  swapping
  884.           activity can lead to a system crash.
  885.  
  886.           If your crashes for  no apparent reason when you  request GRABBER
  887.           to capture the screen, try using the NOSWAP option on the command
  888.           line.   Note that  the NOSWAP option  is valid only  when you are
  889.           initially  installing GRABBER  in memory.   If  you use  it after
  890.           GRABBER is already resident, it will be ignored.
  891.  
  892.  
  893.           Option:   SOUND  and  NOSOUND
  894.  
  895.           Usage:    GRABBER [other options] SOUND
  896.                     GRABBER [other options] NOSOUND
  897.  
  898.           These switches tell GRABBER whether it should beep the computer's
  899.           speaker, or remain silent, when  the filename prompt is displayed
  900.           and when  a screen  capture operation is  successfully completed.
  901.           The default setting is SOUND.  The command GRABBER NOSOUND can be
  902.           used  to silence the  program.  The beep  sounds will then remain
  903.           disabled until the next GRABBER SOUND command is issued.
  904.  
  905.           Please note that GRABBER also makes three low-pitched beep sounds
  906.           whenever it  is unable to capture a screen for any reason.  Using
  907.           the NOSOUND switch does not disable this error indicator.
  908.  
  909.  
  910.           Option:   BATCHCAPTURE  or  BATCHCAPTURE:filename
  911.  
  912.           Usage:    GRABBER BATCHCAPTURE[:filename]
  913.  
  914.           These  options tell a memory-resident copy  of GRABBER to capture
  915.           the current screen immediately.  This is called a "batch capture"
  916.           because the  most useful way to  use these options is  in a batch
  917.           file, when you want to capture  the screen without having to stop
  918.           and press a hotkey.
  919.  
  920.           GRABBER(tm)      Documentation & Technical Notes    Page 17 of 39
  921.  
  922.  
  923.  
  924.           The BATCHCAPTURE options never cause a filename prompt to appear,
  925.           even if  the filename  prompt function  is otherwise  enabled for
  926.           screens captured in the usual way by pressing GRABBER's hotkey.
  927.  
  928.           If  you use BATCHCAPTURE by  itself, the captured  screen will be
  929.           given a file  name according to GRABBER's default "serial number"
  930.           scheme (see page 14 above).  If you use BATCHCAPTURE: followed by
  931.           a file  name, the image will be captured  to a file with the name
  932.           you specify.  The "filename" parameter may be any length, and may
  933.           optionally include  a drive or directory path specification.  For
  934.           example:
  935.  
  936.                      GRABBER BATCHCAPTURE:C:\PICTURES\TESTPIC.EXE
  937.  
  938.           If the batch capture is completed successfully, GRABBER passes an
  939.           errorlevel  of zero  back  to the  batch  file which  issued  the
  940.           BATCHCAPTURE command.  If any error occurs, an errorlevel of 1 is
  941.           returned.
  942.  
  943.           The  BATCHCAPTURE options may be used only after GRABBER has been
  944.           installed in memory.  Also, any other configuration options which
  945.           are  specified on the same  command line as  BATCHCAPTURE will be
  946.           ignored.
  947.  
  948.  
  949.  
  950.           Option:   NOEMS
  951.  
  952.           Usage:    GRABBER [other options] NOEMS
  953.  
  954.           The NOEMS option prevents GRABBER from using EMS expanded memory,
  955.           such as the kind provided by the EMM386.EXE program supplied with
  956.           DOS, the QEMM  and 396^Max programs, and by certain memory-expan-
  957.           sion boards.  If GRABBER  detects that at least 48Kb  of expanded
  958.           memory is available when you initially install it in memory, then
  959.           it will automatically allocate that amount of expanded memory  to
  960.           itself, and use the expanded memory to store  most of its program
  961.           buffers, unless  you specify this option.   If GRABBER is able to
  962.           use expanded memory, then  it will occupy only about  5,000 bytes
  963.           of your system's precious memory below the 1-megabyte DOS thresh-
  964.           old  ("DOS memory").  However, if no expanded memory is available
  965.           (and no UMBs -- see below), then GRABBER will occupy about 20,000
  966.           bytes of DOS memory.  The NOEMS option is not recommended unless,
  967.           in contrast to  the rest of us,  you have DOS memory to  burn and
  968.           you need  to conserve  expanded memory space  for other programs.
  969.           Note that  the  NOEMS  option may only  be specified when you are
  970.           initially installing GRABBER in memory,  and has no effect if you
  971.           specify it after GRABBER is already installed.
  972.  
  973.                SPECIAL  NOTE  FOR QEMM  USERS:    The Quarterdeck  Expanded
  974.           Memory Manager (QEMM)  Versions 6.0 and  later include a  special
  975.           feature  called  "Stealth"  ROM  management  which  is  partially
  976.           incompatible with GRABBER.  If GRABBER detects  that QEMM Stealth
  977.  
  978.           GRABBER(tm)      Documentation & Technical Notes    Page 18 of 39
  979.  
  980.  
  981.  
  982.           has  remapped  your  video BIOS  segment  (which  is  usually the
  983.           segment  at C0000h, but it  can also be  elsewhere), then GRABBER
  984.           will automatically disable EMS  usage as though you  had included
  985.           the  NOEMS option on  the command line.   However, in rare situa-
  986.           tions,  GRABBER might be unable  to detect that  QEMM Stealth has
  987.           remapped  your video BIOS segment.  This  may be the case if your
  988.           system crashes when you attempt to  capture the screen.  To  cure
  989.           this problem,  try  using the  NOEMS  option when  you  initially
  990.           install  GRABBER  in memory.   You  can  still take  advantage of
  991.           GRABBER's  EMS  memory  capability as  long  as  your  video BIOS
  992.           segment is not one of the segments that has been remapped by QEMM
  993.           Stealth.  For  instructions on excluding  the video BIOS  segment
  994.           from  Stealth coverage,  consult  the description  of the  "XST:"
  995.           option in your QEMM documentation.
  996.  
  997.  
  998.           Option:   NOUMB
  999.  
  1000.           Usage:    GRABBER [other options] NOUMB
  1001.  
  1002.           The NOUMB option prevents GRABBER from  using upper memory blocks
  1003.           (UMBs) to store its  program buffers.   (UMBs are regions of  DOS
  1004.           memory  above the 640Kb "conventional memory" limit and below the
  1005.           1-megabyte threshold that  can be enabled  with DOS versions  5.0
  1006.           and  later, on computers with  80386 or later  processors.)  When
  1007.           you  initially install GRABBER in memory, it first looks for 48Kb
  1008.           of EMS expanded memory in which to store its program  buffers, as
  1009.           described above  under the "NOEMS"  option.  If  a 48Kb block  of
  1010.           expanded memory  is not available  (or you specified  the "NOEMS"
  1011.           option), then GRABBER will try to allocate a UMB of 40Kb in which
  1012.           to store its program buffers.  If  one is available, GRABBER will
  1013.           reserve it for  itself unless  you tell it  otherwise using  this
  1014.           option.   As noted above, GRABBER requires only about 5,000 bytes
  1015.           of conventional  DOS memory if a 48Kb block of expanded memory or
  1016.           a 40Kb UMB is available at installation time.  Otherwise, GRABBER
  1017.           requires  about 20,000  bytes of conventional  DOS memory.   Note
  1018.           that the NOUMB option may only be specified when you are initial-
  1019.           ly installing GRABBER in memory, and has no effect if you specify
  1020.           it after GRABBER is already installed.
  1021.  
  1022.  
  1023.           Option:   UNLOAD
  1024.  
  1025.           Usage:    GRABBER UNLOAD
  1026.  
  1027.           The UNLOAD  switch tells GRABBER to search your computer's memory
  1028.           for a  copy of itself that  was previously made resident,  and to
  1029.           remove the program from memory if found.   If removal is success-
  1030.           ful, then a message is displayed at the upper left corner of your
  1031.           screen which states that "GRABBER is not resident in memory," and
  1032.           all memory that GRABBER  was occupying will be released  and made
  1033.           available for other programs.  This includes any conventional DOS
  1034.           memory,  plus any EMS expanded memory or upper memory block (UMB)
  1035.  
  1036.           GRABBER(tm)      Documentation & Technical Notes    Page 19 of 39
  1037.  
  1038.  
  1039.  
  1040.           which  GRABBER may have been using as temporary workspace.  Also,
  1041.           if the  resident copy  of GRABBER  was redirecting  the IRQ0-IRQ7
  1042.           hardware interrupts to somewhere  other than their usual location
  1043.           (see  the "INT=nn" option above), the  UNLOAD option causes these
  1044.           interrupts to be restored to their original locations.
  1045.  
  1046.           GRABBER cannot  be uninstalled if, after  you initially installed
  1047.           it, you continued to load other memory-resident software which is
  1048.           activated by  any of  the  same hardware  or software  interrupts
  1049.           which  GRABBER uses.  Attempting to use GRABBER UNLOAD under such
  1050.           circumstances will not work, and a message to this effect will be
  1051.           displayed.   You should always be able to uninstall GRABBER if it
  1052.           was the most recent memory-resident program to be installed.
  1053.  
  1054.  
  1055.           Option:   DEFAULTDRIVE
  1056.  
  1057.           Usage:    GRABBER [other options] DEFAULTDRIVE
  1058.  
  1059.           The DEFAULTDRIVE switch was described above in the section called
  1060.           "Starting GRABBER."   This switch  can be used both  when you are
  1061.           initially installing  the program in memory,  and thereafter when
  1062.           you wish to cancel  a drive/path destination previously specified
  1063.           and  start writing  .exe  files to  the  default drive  and  path
  1064.           instead.
  1065.  
  1066.           During the  initial  installation of  GRABBER,  the  DEFAULTDRIVE
  1067.           switch  can act as a substitute for the drive and/or path parame-
  1068.           ter  which is otherwise required to make GRABBER stay resident in
  1069.           memory.
  1070.  
  1071.           If  you did  not use  DEFAULTDRIVE  when you  initially installed
  1072.           GRABBER in memory, you can instruct GRABBER to start placing .exe
  1073.           image files  in whatever location happens  to be known  to DOS as
  1074.           its  current "default drive  and path" whenever  a screen capture
  1075.           takes place.
  1076.  
  1077.           After you  use DEFAULTDRIVE, GRABBER  will continue to  place all
  1078.           .exe  image files in DOS's default drive and path until you issue
  1079.           another  command  which includes  a  specific  drive and/or  path
  1080.           parameter as the first item on the command line after the GRABBER
  1081.           command  itself.  For example,  the following command example can
  1082.           be  used to cancel the  effect of a  GRABBER DEFAULTDRIVE command
  1083.           which was issued previously:
  1084.  
  1085.                          GRABBER C:\PICTURES [other options]
  1086.  
  1087.           GRABBER(tm)      Documentation & Technical Notes    Page 20 of 39
  1088.  
  1089.  
  1090.  
  1091.           Option:   NOVESA
  1092.  
  1093.           Usage:    GRABBER [other options] NOVESA
  1094.  
  1095.           (Please refer to the  section on VESA BIOS compatibility  on page
  1096.           34 below.)
  1097.  
  1098.           GRABBER(tm)      Documentation & Technical Notes    Page 21 of 39
  1099.  
  1100.  
  1101.  
  1102.                  PART II:  USING GRABBER'S OFFSPRING .EXE IMAGE FILES
  1103.  
  1104.           The method described  above on pages 6-7 is the  easiest and most
  1105.           common  way  to display  your captured  screen  images.   This is
  1106.           simply to run  the offspring  program file as  a normal  command.
  1107.           You remove the offspring  image from your screen by  pressing any
  1108.           key.
  1109.  
  1110.           Below are described four  different options you can use  to alter
  1111.           the way in which your offspring images leave the screen when they
  1112.           are done.  Used  alone or in  combination with each other,  these
  1113.           options can vastly increase  GRABBER's usefulness, especially  if
  1114.           you know how to use batch files with DOS.
  1115.  
  1116.           For on-screen help  and other useful information with any GRABBER
  1117.           offspring image  file, include the  /? switch on  the offspring's
  1118.           command line.  For example:  SCREEN00 /?
  1119.  
  1120.  
  1121.           FADE-IN SCREEN IMAGES:  "FADEIN"
  1122.           ---------------------------------
  1123.  
  1124.           (This option  works only on VGA systems.  It does not work when a
  1125.           GRABBER .exe offspring image is displayed on a CGA, EGA or Hercu-
  1126.           les monochrome system.)
  1127.  
  1128.           If  you are displaying a GRABBER offspring image on a VGA-compat-
  1129.           ible  system, you can cause the image to "fade in" from blackness
  1130.           by including  the FADEIN keyword  on the offspring  command line.
  1131.           For example:
  1132.                            SCREEN00 [other options] FADEIN
  1133.  
  1134.           The  FADEIN  option has  the effect  of  displaying the  image as
  1135.           though the brightness  control on the monitor  is being gradually
  1136.           turned  up from total  blackness to  its actual  current setting.
  1137.           Although FADEIN  works only  when  a GRABBER  offspring is  being
  1138.           redisplayed on  a VGA  system, it  can be used  with any  text or
  1139.           graphics image, even if  it was originally captured on  a non-VGA
  1140.           system.
  1141.  
  1142.  
  1143.           FADE-OUT SCREEN IMAGES:  "FADEOUT"
  1144.           ----------------------------------
  1145.  
  1146.           (This option works only on VGA systems.   It does not work when a
  1147.           GRABBER .exe offspring image is displayed on a CGA, EGA or Hercu-
  1148.           les monochrome system.)
  1149.  
  1150.           As a  complement to the FADEIN option  (see above), you can cause
  1151.           the image to  "fade out"  to blackness by  including the  FADEOUT
  1152.           keyword on the offspring command line.  For example:
  1153.  
  1154.                            SCREEN00 [other options] FADEOUT
  1155.  
  1156.           GRABBER(tm)      Documentation & Technical Notes    Page 22 of 39
  1157.  
  1158.  
  1159.  
  1160.           The FADEOUT option has the effect of removing the offspring image
  1161.           from the screen as  though the brightness control on  the monitor
  1162.           is being gradually turned down from its actual current setting to
  1163.           total  blackness.   Although  FADEOUT works  only when  a GRABBER
  1164.           offspring is being  redisplayed on a  VGA system, it can  be used
  1165.           with  any text  or  graphics image,  even  if it  was  originally
  1166.           captured on a non-VGA system.
  1167.  
  1168.           The FADEOUT option  can be  combined with the  FADEIN option  de-
  1169.           scribed  above, and  with all  other offspring  options described
  1170.           here, except /F and /N.  If you combine FADEOUT with the /F or /N
  1171.           switches, FADEOUT will be ignored.
  1172.  
  1173.  
  1174.           TIMED EXECUTION:  /Tn
  1175.           ----------------------
  1176.  
  1177.           If you  have an  offspring file called  SCREEN00 and you  want to
  1178.           display it  on your  screen only  for a  certain length  of time,
  1179.           *and* you don't want to press a key to  make it go away, use this
  1180.           command at the DOS prompt or within a batch file:
  1181.  
  1182.                                      SCREEN00 /Tn
  1183.  
  1184.           The  'n' character represents a time value, in seconds, which you
  1185.           specify.  The 'n' value may be any positive integer between 1 and
  1186.           3600.   (3600 seconds equals exactly one  hour.)  For example, if
  1187.           you  use the  command SCREEN00  /T20, then  the image  within the
  1188.           offspring program will be displayed on your screen for exactly 20
  1189.           seconds,  after which it erases itself and the program exits back
  1190.           to the DOS  prompt or batch  file, just  as it would  if you  had
  1191.           entered SCREEN00 alone, without the parameter.
  1192.  
  1193.           If you  want to exit the  SCREEN00 image before  'n' seconds have
  1194.           elapsed,  you can press  <Ctrl-C>.   Pressing <Ctrl-C>  sends and
  1195.           "errorlevel" of 255 back to the calling batch file.
  1196.  
  1197.           You  may  combine the  /Tn option  together  with the  /K keylist
  1198.           option described below on page 24.  For example:
  1199.  
  1200.                                  SCREEN00 /T60 /K:123
  1201.  
  1202.           In this example,  the SCREEN00  image will remain  on the  screen
  1203.           until 60 seconds have elapsed, or until the user presses the <1>,
  1204.           <2>  or <3> key, whichever occurs first.  (Pressing <Ctrl-C> will
  1205.           also exit  the image  with an  errorlevel of 255.)   If  the user
  1206.           presses any key other than <Ctrl-C>  or the keys specified in the
  1207.           /K  keylist,  the keystrokes  will be  ignored.   For  a complete
  1208.           explanation of  the errorlevel effects  you can achieve  with the
  1209.           keys in the keylist, see the discussion of the /K option starting
  1210.           below on page 24.
  1211.  
  1212.           GRABBER(tm)      Documentation & Technical Notes    Page 23 of 39
  1213.  
  1214.  
  1215.  
  1216.           You may also combine the  /Tn option together with the  /F option
  1217.           described below.  If you do this, the image will not erase itself
  1218.           from the screen (as it normally would) when the offspring program
  1219.           exits back  to the DOS prompt  or to the batch  file which called
  1220.           it.
  1221.  
  1222.           The /Tn option is especially useful when you want to run a "slide
  1223.           show" routine on an unattended computer.  Try this DOS command:
  1224.  
  1225.                            FOR %F IN (SCREEN??.*) DO %F /T5
  1226.  
  1227.           (Within a batch file, use %%F instead of %F throughout this exam-
  1228.           ple.)
  1229.  
  1230.           You may  not  use the  /Tn option  together with  the /N  option,
  1231.           below.
  1232.  
  1233.  
  1234.           DON'T CLEAR SCREEN ON EXIT: /F
  1235.           -------------------------------
  1236.  
  1237.           Unless you  tell an offspring  program otherwise, it  will assume
  1238.           that you want the screen  to be cleared completely when  you exit
  1239.           the  program.  However, if you want  to exit an offspring program
  1240.           and leave intact the image it places on the display, then use the
  1241.           /F switch  when you execute it  from the DOS prompt  or from your
  1242.           batch file, like this:
  1243.  
  1244.                                      SCREEN00 /F
  1245.  
  1246.           With character-based text screens, the /F option can  enhance the
  1247.           appearance of  a  batch-driven "slide  show"  or menu  system  by
  1248.           eliminating the  blank screens  which appear briefly  between the
  1249.           offspring programs being executed by the batch file.
  1250.  
  1251.           Please note that the /F option does not affect how long the image
  1252.           will  remain on the  screen, or  what keypress  (if any)  will be
  1253.           required to exit the  offspring program.  The exact  method which
  1254.           the offspring program  uses to  exit will depend  on whether  you
  1255.           have  also specified  any  of the  other switches  described here
  1256.           (i.e. /Tn, /N, /K, or no switch at all).   All the /F option does
  1257.           is to prevent the  display from being cleared when  the offspring
  1258.           program does exit.
  1259.  
  1260.           The /F option may be  used together with the /Tn  option (above),
  1261.           and with the /N option (below), and with the /K option (below).
  1262.  
  1263.           GRABBER(tm)      Documentation & Technical Notes    Page 24 of 39
  1264.  
  1265.  
  1266.  
  1267.           DON'T WAIT FOR ANY KEYPRESS: /N
  1268.           --------------------------------
  1269.  
  1270.           Unless you  tell an offspring  program otherwise, it  will assume
  1271.           that you want to wait for some keyboard input before  exiting the
  1272.           offspring  program and returning to DOS.  However, if you want to
  1273.           display  the offspring image and exit immediately back to the DOS
  1274.           command  line or  batch file  from which  it was  called, without
  1275.           waiting  for any  keyboard input,  then use  the /N  switch, like
  1276.           this:
  1277.                                      SCREEN00 /N
  1278.  
  1279.           There is no need  to also specify the /F switch, described above,
  1280.           when you use the /N switch.  Whenever you  use the /N switch, the
  1281.           offspring program  automatically assumes that you  want the image
  1282.           to remain  on the display after the  program has exited, and sets
  1283.           the /F switch for you.
  1284.  
  1285.           The  /N option  may be  used by  itself, or  with the  /Tn option
  1286.           above.   However, /N may not be used with the /K option described
  1287.           below.
  1288.  
  1289.  
  1290.           KEYLIST OPERATION: /K
  1291.           ----------------------
  1292.  
  1293.           This option is supported for all offspring files.  The format is:
  1294.  
  1295.                                     SCREEN00 /K...
  1296.  
  1297.           The format of the "/K..." parameter is explained below.
  1298.  
  1299.           GRABBER offspring files which  you view from a batch  (.BAT) file
  1300.           can communicate with the batch file using the ERRORLEVEL facility
  1301.           built into DOS.  This allows you to create offspring screens that
  1302.           interact  with the  user, by branching  control within  the batch
  1303.           file based on the user's keyboard response.
  1304.  
  1305.           This method of displaying  an offspring file works only  when you
  1306.           display it  from within a batch file.  If  you do not know how to
  1307.           create  a batch file, or how the ERRORLEVEL principle works, then
  1308.           you should consult these topics in your DOS manual before contin-
  1309.           uing.  It's actually very simple.
  1310.  
  1311.           Let's set up  an example.   Say you have  created a GRABBER  off-
  1312.           spring image to use as  a menu screen on your PC.   This image is
  1313.           called  MENU.EXE.  You want  to use this menu  to give a user the
  1314.           choice  to run one  of three different programs.   The three pro-
  1315.           grams are called:
  1316.  
  1317.                     1.   WORDPROC.COM   (a word processor)
  1318.                     2.   SPREAD.EXE     (a spreadsheet program)
  1319.                     3.   CHESS.COM      (a game)
  1320.  
  1321.           GRABBER(tm)      Documentation & Technical Notes    Page 25 of 39
  1322.  
  1323.  
  1324.  
  1325.           And your MENU.EXE image looks something like this:
  1326.  
  1327.                     _____________________________________
  1328.                     |                                   |
  1329.                     |     To get to...      Press...    |
  1330.                     |   -----------------   --------    |
  1331.                     |    Word Processing       A        |
  1332.                     |    Spreadsheet           B        |
  1333.                     |    Chess Game            C        |
  1334.                     |                                   |
  1335.                     |___________________________________|
  1336.  
  1337.  
  1338.           Now, all you need to do is create a  batch file, (say it's called
  1339.           SHOWMENU.BAT), which looks something like this:
  1340.  
  1341.  
  1342.  
  1343.                             Sample batch file SHOWMENU.BAT
  1344.                            --------------------------------
  1345.  
  1346.  
  1347.           (Line no.)
  1348.                     _____________________________________________
  1349.                     |                                           |
  1350.                1    |   :BEGIN                                  |
  1351.                2    |   ECHO OFF                                |
  1352.                3    |   CLS                                     |
  1353.                4    |   MENU /K:A B C                           |
  1354.                5    |   IF ERRORLEVEL 255 GOTO :BREAK_EXIT      |
  1355.                6    |   IF ERRORLEVEL 3 GOTO :RUN_CHESS         |
  1356.                7    |   IF ERRORLEVEL 2 GOTO :RUN_SPREADSHEET   |
  1357.                8    |   IF ERRORLEVEL 1 GOTO :RUN_WORDPROC      |
  1358.                9    |   :RUN_CHESS                              |
  1359.                10   |   CHESS                                   |
  1360.                11   |   GOTO :BEGIN                             |
  1361.                12   |   :RUN_SPREADSHEET                        |
  1362.                13   |   SPREAD                                  |
  1363.                14   |   GOTO :BEGIN                             |
  1364.                15   |   :RUN_WORDPROC                           |
  1365.                16   |   WORDPROC                                |
  1366.                17   |   GOTO :BEGIN                             |
  1367.                18   |   :BREAK_EXIT                             |
  1368.                     |                                           |
  1369.                     |___________________________________________|
  1370.  
  1371.  
  1372.           You  are ready  to  go.   Execute  SHOWMENU.BAT by  entering  the
  1373.           command SHOWMENU at the DOS prompt,  or by including it as a line
  1374.           (preferably the last line) in your AUTOEXEC.BAT file.
  1375.  
  1376.           GRABBER(tm)      Documentation & Technical Notes    Page 26 of 39
  1377.  
  1378.  
  1379.  
  1380.           WHAT SHOWMENU.BAT DOES
  1381.           -----------------------
  1382.  
  1383.           Lines 2 and 3 of SHOWMENU.BAT clean up  the screen in preparation
  1384.           for your menu.  The  action begins at Line 4.  At this point, DOS
  1385.           runs your MENU.EXE program, which displays the menu screen.
  1386.  
  1387.           Notice  the parameter  /K:A,B,C which  follows the  MENU command.
  1388.           This  is your Keylist, and  it tells the  offspring program which
  1389.           keys can be used to  exit the screen.  If the user  presses other
  1390.           keys,  they will be  ignored.  Note  also the order  in which the
  1391.           keys  are  specified.    This  is  very  important,  because  the
  1392.           ERRORLEVEL which MENU.EXE will  assign to a key is  determined by
  1393.           its position in the keylist "A B C".
  1394.  
  1395.           If  the  user  presses <A>,  then  MENU.EXE  ends  by sending  an
  1396.           ERRORLEVEL  of 1  back to  the batch  file.   This value  will be
  1397.           ignored by Lines 5, 6 and 7 of the SHOWMENU file, but Line 8 will
  1398.           pick it  up as  a signal  to branch  to the  instructions labeled
  1399.           ":RUN_WORDPROC"  at Line 15.  Following this label is the command
  1400.           WORDPROC, which starts up your word processing program.
  1401.  
  1402.           Likewise, if the  user presses  <B>, then MENU.EXE  will send  an
  1403.           ERRORLEVEL of 2 back to the batch file, because "B" is the second
  1404.           choice  in your Keylist.  Line 7 takes this as a cue to jump down
  1405.           to the instructions beneath ":RUN_SPREADSHEET" at Line 12.
  1406.  
  1407.           And so forth.  Remember one  very important thing.  When you test
  1408.           the ERRORLEVEL values in  a batch file, follow the  example shown
  1409.           in  SHOWMENU.BAT  by always  testing  them  in descending  order.
  1410.           Start  with the highest possible  value and continue  down to the
  1411.           lowest possible value. 
  1412.  
  1413.           Why does  SHOWMENU test  for an  ERRORLEVEL of 255  in the  fifth
  1414.           line?  This is because there is a always a  "back door" exit from
  1415.           an  offspring program  like MENU.EXE which  is running  under the
  1416.           control of a Keylist.   This is done by pressing either  <CTRL C>
  1417.           or <CTRL BREAK> while the image is on your screen, both  of which
  1418.           produce  what is commonly called a "break" signal in your comput-
  1419.           er.   Whenever you press <CTRL C>  or <CTRL BREAK>, the offspring
  1420.           program  always sends  an ERRORLEVEL  of 255  back to  your batch
  1421.           file, and exits the screen.
  1422.  
  1423.           Note also, that spaces  are used to  separate the choices in  the
  1424.           Keylist  in Line  4 of  SHOWMENU.BAT.   If  the user  presses the
  1425.           spacebar, it will be ignored.   This is one of several keys which
  1426.           GRABBER offspring programs reserve for their own use when examin-
  1427.           ing your  Keylist.   You  can  use these  keys to  separate  your
  1428.           choices for  readability, but none can be  used to identify a key
  1429.           choice.  These "reserved" keys are:  the comma, the spacebar, the
  1430.           Tab key,  the colon  (:), the semicolon  (;), and the  slash (/).
  1431.           Therefore,  each of the following ways of specifying a Keylist is
  1432.           identical to the others:
  1433.  
  1434.           GRABBER(tm)      Documentation & Technical Notes    Page 27 of 39
  1435.  
  1436.  
  1437.  
  1438.                                    MENU /KABC
  1439.                                    MENU /K a b c
  1440.                                    MENU /k:A b C
  1441.                                    MENU /K a:B:c
  1442.  
  1443.           The GRABBER offspring program will function identically in either
  1444.           situation.
  1445.  
  1446.           In addition to any alpha key (A through Z) and any numeric key (0
  1447.           through 9),  you may include  in your keylist any  of the special
  1448.           function  keys listed  below.   Please  note  that it  takes  two
  1449.           characters to identify any of the following function keys on your
  1450.           command line,  and the first  character is  always the  backslash
  1451.           (\).
  1452.  
  1453.                     To use this PC key       Use this code on
  1454.                     in your keylist...       the command line
  1455.                     --------------------     ------------------
  1456.                           <F1>                      \1
  1457.                           <F2>                      \2
  1458.                           <F3>                      \3
  1459.                           <F4>                      \4
  1460.                           <F5>                      \5
  1461.                           <F6>                      \6
  1462.                           <F7>                      \7
  1463.                           <F8>                      \8
  1464.                           <F9>                      \9
  1465.                           <F10>                     \0
  1466.  
  1467.                           <Home>                    \H
  1468.                           <PgUp>                    \P
  1469.                           <End>                     \E
  1470.                           <PgDn>                    \N
  1471.                           <Up Arrow>                \U
  1472.                           <Down Arrow>              \D
  1473.                           <Left Arrow>              \L
  1474.                           <Right Arrow>             \R
  1475.                           <Esc>                     \X
  1476.  
  1477.  
  1478.           The /K keylist  option may be used with the  /Tn option described
  1479.           above  on page 22, but not with  the /N option described above on
  1480.           page 24.   If you specify a keylist together  with the /N option,
  1481.           the keylist  will be ignored.   You  may also use  the /K  option
  1482.           together with the /F option described above on page 24.
  1483.  
  1484.           GRABBER(tm)      Documentation & Technical Notes    Page 28 of 39
  1485.  
  1486.  
  1487.  
  1488.           DISPLAYING SUPER-VGA GRAPHICS
  1489.           ------------------------------
  1490.  
  1491.           If  a GRABBER offspring file contains  a Super-VGA graphic image,
  1492.           then you may have to take special steps to redisplay  it properly
  1493.           on your screen.
  1494.  
  1495.           For 16-color graphic screens, "Super-VGA" means that the image is
  1496.           larger  than  640 x  480 dots.    For 256-color  graphic screens,
  1497.           "Super-VGA" means that the image is larger than 320 x 200 dots.
  1498.  
  1499.           Remember, you may check a graphic image's resolution, and receive
  1500.           on-screen  help and  other useful  information, by  executing the
  1501.           offspring .exe  file with the /? switch on the command line.  For
  1502.           example:  SCREEN00 /?
  1503.  
  1504.           If you have a Super-VGA adapter that is VESA-compatible, then you
  1505.           should  be able to redisplay most Super-VGA images just by enter-
  1506.           ing the screen name at the DOS prompt or in a batch file, without
  1507.           any special parameters.  The  following types of Super-VGA images
  1508.           can be  redisplayed on  VESA-compatible systems without  any com-
  1509.           mand-line  parameters,  assuming  the  adapter  has  enough video
  1510.           memory installed:
  1511.  
  1512.  
  1513.                *  640 x 400 x 256            *  800 x 600 x 16
  1514.                *  640 x 480 x 256            *  1024 x 768 x 16
  1515.                *  800 x 600 x 256
  1516.                *  1024 x 768 x 256
  1517.  
  1518.  
  1519.           If your  Super-VGA adapter is not  VESA-compatible, however, then
  1520.           you must tell  each Super-VGA  offspring file which  type of  VGA
  1521.           chipset is employed by your adapter.  Use this example:
  1522.  
  1523.                           SCREEN00 [other options] @CHIPTYPE
  1524.  
  1525.           Super-VGA offspring  files recognize  the  following VGA  chipset
  1526.           names.  Use  one of these  in place of  "@chiptype" in the  above
  1527.           example:
  1528.  
  1529.           GRABBER(tm)      Documentation & Technical Notes    Page 29 of 39
  1530.  
  1531.  
  1532.  
  1533.           @ATI           ATI Technologies chips
  1534.           @VIDEO7        Video Seven chips
  1535.           @HEADLAND      Headland Technology chips
  1536.           @PARADISE      Paradise PVGA chips
  1537.           @WD            Western Digital WD90C00 chips
  1538.           @TSENG3        Tseng Laboratories ET-3000 chip
  1539.           @TSENG4        Tseng Laboratories ET-4000 chip
  1540.           @STB4          STB adapters using the Tseng Labs ET-4000 chip
  1541.           @AHEADA        Ahead Systems chip version "A"
  1542.           @AHEADB        Ahead Systems chip version "B"
  1543.           @GENOA         Genoa GVGA chip (used by 6000 series cards)
  1544.           @OAK           Oak Technology OTI-067 chip
  1545.           @TRIDENT       Trident chips
  1546.           @NCR           NCR 77C22E chip
  1547.  
  1548.  
  1549.           Instead of telling each Super-VGA offspring file what type of VGA
  1550.           chipset is installed, you  can also set a permanent  DOS environ-
  1551.           ment variable called "SVGA=" which serves the same function.  For
  1552.           example, if your Super-VGA adapter employs the Tseng Labs ET-4000
  1553.           chipset, you should enter the following command at the DOS prompt
  1554.           or in your AUTOEXEC.BAT startup file:
  1555.  
  1556.                                    SET SVGA=TSENG4
  1557.  
  1558.           (If you have a different type of VGA chipset, substitute its name
  1559.           from the  list above in place  of "TSENG4" in this  example.)  If
  1560.           you do not include a "@chiptype" parameter on the command line of
  1561.           a  Super-VGA offspring file, it will look for a "SVGA=" parameter
  1562.           in your  DOS environment, and use  it instead.  Note  that on the
  1563.           command  line, you should precede  the chipset name  with the "@"
  1564.           symbol,  but when using the SET  SVGA command you should omit the
  1565.           "@" symbol.
  1566.  
  1567.           Finally, as a last resort, if your Super-VGA adapter is not VESA-
  1568.           compatible and you  do not include  a "@chiptype" parameter  that
  1569.           matches your  adapter type, the offspring file will still attempt
  1570.           to  display the image by looking for an 8514/A Adapter Interface,
  1571.           and using  it if available.   If your  video adapter is  supplied
  1572.           with  a memory-resident  Adapter  Interface  driver,  you  should
  1573.           install the  driver in memory before  running Super-VGA offspring
  1574.           files,  to  make sure  that  you will  be able  to  redisplay any
  1575.           possible type of Super-VGA offspring file.
  1576.  
  1577.           If  you see the message  "Unsupported video mode,"  it means that
  1578.           the  Super-VGA offspring  file  was unable  to  find any  way  of
  1579.           setting the video mode that is required to redisplay the image on
  1580.           the video adapter you are currently using.
  1581.  
  1582.           GRABBER(tm)      Documentation & Technical Notes    Page 30 of 39
  1583.  
  1584.  
  1585.  
  1586.           PORTABILITY ISSUES:
  1587.           OFFSPRING FILE COMPATIBILITY WITH OTHER SYSTEMS
  1588.           ------------------------------------------------
  1589.  
  1590.           This section contains important information which you should read
  1591.           if you have a GRABBER offspring file which you plan to display on
  1592.           a system other than the one  from which the image was  originally
  1593.           captured.
  1594.  
  1595.           In  general, GRABBER  offspring files, and  particularly graphic-
  1596.           mode offspring,  are very device-dependent programs.   This means
  1597.           that  with a  few  types of  text-mode  offspring and  with  most
  1598.           graphic-mode offspring, you cannot  display an offspring image on
  1599.           another  computer unless the  other computer has  a video adapter
  1600.           that is  at least  as technically  "advanced," or more  advanced,
  1601.           than  the  video adapter  from  which  the image  was  originally
  1602.           captured.  In this context, how "technically advanced" an adapter
  1603.           is depends on the maximum number of colors and the maximum number
  1604.           of pixels it  can display  at one time.   Here is  a list of  the
  1605.           video  adapters which  GRABBER offspring  can support,  ranked in
  1606.           order from least advanced to most advanced:
  1607.  
  1608.             *  Monochrome Display Adapter (MDA)
  1609.             *  Monochrome Graphics Adapter (MGA; Hercules-compatible)
  1610.             *  Color Graphics Adapter (CGA)
  1611.             *  Enhanced Graphics Adapter (EGA)
  1612.             *  Video Gate Array adapter (VGA)
  1613.             *  Super-VGA adapters (SVGA)
  1614.             *  Adapter Interface (AI) compatibles (incl. 8514/A and XGA)
  1615.  
  1616.           The  following  chart  lists  the different  types  of  text-mode
  1617.           screens  which GRABBER can capture,  and also lists  the types of
  1618.           video systems from which they can be captured, and to which  they
  1619.           can be transported.  (S)VGA means both VGA and SVGA.
  1620.  
  1621.  
  1622.                               CAN BE                CAN BE "PLAYED BACK" ON
  1623.           TEXT MODES          CAPTURED FROM:        THESE VIDEO SUBSYSTEMS:
  1624.           ----------------    ------------------    -----------------------
  1625.           * 80 x 25 color     CGA EGA (S)VGA        MDA MGA CGA EGA (S)VGA
  1626.  
  1627.           * 80 x 25 mono      MDA MGA EGA (S)VGA    MDA MGA CGA EGA (S)VGA
  1628.  
  1629.           * 40 x 25 color     CGA EGA (S)VGA        CGA EGA (S)VGA
  1630.  
  1631.           * 80 x 43           EGA (S)VGA            EGA (S)VGA
  1632.  
  1633.           * 80 x 28 or 50     (S)VGA                (S)VGA
  1634.  
  1635.           * 132-col. modes    SVGA                  SVGA
  1636.  
  1637.           Most 132-column screens can  only be ported to Super-VGAs  of the
  1638.           same OEM origin, unless the destination system is VESA-compliant.
  1639.  
  1640.           GRABBER(tm)      Documentation & Technical Notes    Page 31 of 39
  1641.  
  1642.  
  1643.  
  1644.           OFFSPRING FILE COMPATIBILITY WITH OTHER SYSTEMS (continued)
  1645.           ------------------------------------------------------------
  1646.  
  1647.           With  graphic-mode  offspring   files,  the  compatibility  issue
  1648.           follows  a  pattern similar  to text-mode  files.   Each  mode is
  1649.           listed according to its X-resolution, Y-resolution, and number of
  1650.           colors, in that order.   ("MCGA" represents the Multicolor Graph-
  1651.           ics Adapter found in the IBM PS/2 models 25 and 30.)
  1652.  
  1653.  
  1654.                               CAN BE CAPTURED       CAN BE "PLAYED BACK" ON
  1655.           GRAPHIC MODES       FROM ANY OF THESE:    ANY OF THESE SYSTEMS:
  1656.           -----------------   ------------------    -----------------------
  1657.           * 720 x 348 x 2     MGA                   MGA
  1658.           * 320 x 200 x 4     (M)CGA EGA (S)VGA     (M)CGA EGA (S)VGA
  1659.           * 640 x 200 x 2     (M)CGA EGA (S)VGA     (M)CGA EGA (S)VGA
  1660.           * 320 x 200 x 16    EGA (S)VGA            EGA (S)VGA
  1661.           * 640 x 200 x 16    EGA (S)VGA            EGA (S)VGA
  1662.           * 640 x 350 x 2     EGA (S)VGA            EGA (S)VGA
  1663.           * 640 x 350 x 16    EGA (S)VGA            EGA (S)VGA
  1664.           * 640 x 480 x 2     MCGA (S)VGA           MCGA (S)VGA
  1665.           * 640 x 480 x 16    (S)VGA  AI            (S)VGA  AI
  1666.           * 320 x 200 x 256   MCGA (S)VGA           MCGA (S)VGA
  1667.  
  1668.           * 800 x 600
  1669.             (16/256 colors)   SVGA                  SVGA  AI
  1670.  
  1671.           * 640 x 400 x 256   SVGA                  SVGA  AI
  1672.  
  1673.           * 640 x 480 x 256   SVGA  AI              SVGA  AI
  1674.  
  1675.           * 1024 x 768
  1676.             (16/256 colors)   SVGA  AI              SVGA  AI
  1677.  
  1678.  
  1679.           In  order to  transport  a  graphic  of Super-VGA  resolution  to
  1680.           another OEM's  SVGA adapter, the destination  adapter must either
  1681.           be  VESA-compliant, or employ a VGA chipset with which GRABBER is
  1682.           compatible (see page 9 above).
  1683.  
  1684.           To  transport a graphic of  Super-VGA resolution to  an 8514/A or
  1685.           compatible adapter,  the destination system must  have an Adapter
  1686.           Interface  (AI) driver resident in memory, such as IBM's or ATI's
  1687.           HDILOAD driver.
  1688.  
  1689.           GRABBER(tm)      Documentation & Technical Notes    Page 32 of 39
  1690.  
  1691.  
  1692.  
  1693.           USING GRABBER WITH MICROSOFT WINDOWS
  1694.           -------------------------------------
  1695.  
  1696.           GRABBER is designed to work with programs that run in "real mode"
  1697.           or "virtual 8086" mode under  MS-DOS.  If you are running  an MS-
  1698.           DOS application  in  full-screen mode  under  Microsoft  Windows,
  1699.           GRABBER should be  able to capture screens  from that application
  1700.           just as though you were running it outside of Windows.
  1701.  
  1702.           GRABBER is not specifically  designed to capture images from  the
  1703.           Windows  desktop itself,  or from  MS-DOS applications  which are
  1704.           running  in a window instead  of full-screen mode.   However, you
  1705.           might  still be able to use GRABBER  to capture the Windows desk-
  1706.           top.
  1707.  
  1708.           Note:   Make sure you install GRABBER in memory *before* starting
  1709.           Windows.  Also, make sure you use the INT=OFF command-line option
  1710.           (described above  on page 13) when you  initially install GRABBER
  1711.           in memory; if you don't, GRABBER will not allow Windows to load.
  1712.  
  1713.           While  Windows  is  running, GRABBER  automatically  changes  its
  1714.           hotkey  combination to  [Ctrl  Shift].   When  you exit  Windows,
  1715.           GRABBER's hotkey combination reverts back to [Ctrl =] or whatever
  1716.           you may have changed it to be.
  1717.  
  1718.           Also, while Windows is running, GRABBER ignores the status of the
  1719.           PROMPT option and disables all on-screen prompts.  Captured files
  1720.           will  be named WIN00.EXE, WIN01.EXE, and so forth.  When you exit
  1721.           Windows, GRABBER will  resume following the status  of the PROMPT
  1722.           option.
  1723.  
  1724.           Whether  your offspring screens turn out correctly will depend on
  1725.           what type  of video  hardware is  installed, which Windows  video
  1726.           driver you are using, and what other memory-resident programs are
  1727.           also loaded.  GRABBER  has been known to  work using the  generic
  1728.           VGA video driver supplied with Windows 3.1 (640 x 480 x 16 mode),
  1729.           as  well  as with  recent Super-VGA  drivers  for ATI  VGA Wonder
  1730.           adapters  and adapters based on the Tseng Labs ET4000 chipset (in
  1731.           the 640 x  480 and 1,024 x  768 x 256 modes).   It may work  with
  1732.           other Super-VGA cards.   It will not  work with XGA,  8514/A, ATI
  1733.           Mach-8, ATI Mach-32, S-Cubed, or other video coprocessor drivers.
  1734.  
  1735.           After  GRABBER captures  a  Windows screen,  it  might upset  the
  1736.           Windows video  driver in such a  way that garbage is  left on the
  1737.           screen when you move the  mouse, push menu items and  buttons, or
  1738.           move graphic objects around.  To  cure this, exit back to DOS and
  1739.           restart Windows.
  1740.  
  1741.           Please note, again, that GRABBER is designed for use only  in the
  1742.           MS-DOS environment.  While it is unquestionably the most reliable
  1743.           MS-DOS screen capture system you will find anywhere, it has never
  1744.           been  advertised (or  supported) by  the publisher  as a  Windows
  1745.           screen capture program.
  1746.  
  1747.           GRABBER(tm)      Documentation & Technical Notes    Page 33 of 39
  1748.  
  1749.  
  1750.  
  1751.           CHANGING GRABBER'S HOTKEY
  1752.           --------------------------
  1753.  
  1754.           (The  information  in  this   section  applies  to  the  separate
  1755.           GRTXT.EXE, GR4AI.EXE, and GRPCX.EXE programs also.)
  1756.  
  1757.           GRABBER allows you  to change the keystroke  sequence which acti-
  1758.           vates the program, from the default  [Ctrl =] to almost any other
  1759.           sequence you choose.
  1760.  
  1761.           If GRABBER is already  active in your computer's memory,  you may
  1762.           tell the resident copy of GRABBER that you want to  start using a
  1763.           different  hotkey than the one it  currently recognizes, and make
  1764.           the  change become effective immediately.  GRABBER also gives you
  1765.           the  option of making your hotkey change permanent, by saving the
  1766.           new hotkey information back to the GRABBER.EXE file itself.  When
  1767.           you  use  this option,  the hotkey  you  choose will  take effect
  1768.           automatically every time you install GRABBER in memory by loading
  1769.           the altered GRABBER.EXE file.
  1770.  
  1771.           Every GRABBER  hotkey has two  parts.  We'll call  them the "KEY"
  1772.           and the "SHIFT".  The KEY can be an alphanumeric  key such as the
  1773.           letter <A>  or the number <4>,  or a punctuation key  such as the
  1774.           <;>, or a function key such as <F10>, <Esc>, <PgDn> or <Del>.  In
  1775.           GRABBER's default [Ctrl =] hotkey, the  equal sign <=> is the KEY
  1776.           part.
  1777.  
  1778.           The SHIFT part  of your hotkey can be made  up of any combination
  1779.           of the following  keys on  your keyboard:   <Shift>, <Ctrl>,  and
  1780.           <Alt>.  In  GRABBER's default [Ctrl =] hotkey, the  <Ctrl> key is
  1781.           the SHIFT part.
  1782.  
  1783.           You can specify a GRABBER hotkey on the command line either  when
  1784.           you  are initially  installing  the program  in  memory, or  when
  1785.           re-invoking GRABBER  after  it is  already  resident.   Use  this
  1786.           syntax:
  1787.  
  1788.                GRABBER  [other options]  KEY=kk  SHIFT=ss  [SAVEHOTKEY]
  1789.  
  1790.           "kk"  represents a two-character KEY  code.  Valid  KEY codes are
  1791.           listed in Appendix A of this manual.
  1792.  
  1793.           "ss" represents  a two-character SHIFT  code.  Valid  SHIFT codes
  1794.           are listed in Appendix B of this manual.
  1795.  
  1796.           The SAVEHOTKEY parameter is optional.  When you include it on the
  1797.           command line together with the KEY=kk and SHIFT=ss parameters, it
  1798.           instructs GRABBER to save  your new hotkey choice  permanently to
  1799.           the GRABBER.EXE file.  This way, your new hotkey will take effect
  1800.           automatically every time you reinstall GRABBER in memory, and you
  1801.           won't have  to specify  your new  KEY=kk and SHIFT=ss  parameters
  1802.           every time  you restart the program.   If you do  not include the
  1803.           SAVEHOTKEY parameter,  the hotkey  you specify will  be effective
  1804.  
  1805.           GRABBER(tm)      Documentation & Technical Notes    Page 34 of 39
  1806.  
  1807.  
  1808.  
  1809.           only for  as long as the current copy of GRABBER remains resident
  1810.           in  memory, or  until you  change it  again with  new  KEY=kk and
  1811.           SHIFT=ss codes.
  1812.  
  1813.           Please  read Appendices A and B for additional important informa-
  1814.           tion.
  1815.  
  1816.  
  1817.  
  1818.           TESTING THE RELIABILITY OF YOUR VESA BIOS EXTENSION
  1819.           ----------------------------------------------------
  1820.  
  1821.           As mentioned above on  pages 4-5, GRABBER is compatible  with VGA
  1822.           systems  which  include  support  for  the  VESA  BIOS  Extension
  1823.           ("VBE"). The VBE is  a standardized method by which  programs can
  1824.           take advantage  of the enhanced capabilities  of high-performance
  1825.           video  adapters, independently of the adapters' specific hardware
  1826.           layouts, which vary among  different manufacturers.  An adapter's
  1827.           support for  the VBE can  take the form  of a set  of programming
  1828.           routines  which are  either  permanently built  into the  adapter
  1829.           itself,  or are added by loading  a software VBE driver into your
  1830.           computer's memory by way of your CONFIG.SYS or AUTOEXEC.BAT file.
  1831.           Some newer VGA adapters  have VBE support built into  the adapter
  1832.           itself, while most  older adapters can  be supplemented with  VBE
  1833.           support  using a  software  driver which  is  available from  the
  1834.           manufacturer.
  1835.  
  1836.           Although the VBE is  now a "standard" in the  microcomputer video
  1837.           industry,  some VBE  software  drivers (and  even some  hardware-
  1838.           encoded  VBE drivers)  exist which  do not  fully conform  to the
  1839.           official  VESA BIOS  specifications.   In  short, they  have bugs
  1840.           which prevent programs such as GRABBER from working reliably with
  1841.           the video hardware.
  1842.  
  1843.           When you install GRABBER in memory, it checks for the presence of
  1844.           VBE support  for your video  adapter.   If it finds  VBE support,
  1845.           GRABBER  will automatically  attempt to  use it, unless  you tell
  1846.           GRABBER  otherwise.   However, if  your VBE  driver (hardware  or
  1847.           software)  is one of those that are not fully compliant with VESA
  1848.           specifications, GRABBER may not function properly.
  1849.  
  1850.           The purpose of  the CHKVBE.EXE program  included on your  GRABBER
  1851.           distribution diskette is to help you identify whether your system
  1852.           has VBE  support, and  if so, whether  your VBE  driver is  fully
  1853.           compatible with GRABBER and the VESA specifications.
  1854.  
  1855.           CHKVBE is executed without  parameters.  If it reports  that your
  1856.           system has no VBE support,  or has VBE support which "appears  to
  1857.           be compatible with GRABBER," then no further action is necessary,
  1858.           and you can install GRABBER in memory as usual.
  1859.  
  1860.           However, if CHKVBE reports that your system has VBE support which
  1861.           "appears  to  be  incompatible  with GRABBER,"  then  you  should
  1862.  
  1863.           GRABBER(tm)      Documentation & Technical Notes    Page 35 of 39
  1864.  
  1865.  
  1866.  
  1867.           prevent GRABBER from attempting  to use the VBE by  including the
  1868.           NOVESA switch on  the command  line when you  install GRABBER  in
  1869.           memory.  For example:
  1870.  
  1871.                           GRABBER [other parameters] NOVESA
  1872.  
  1873.           (If your system crashes  when you execute CHKVBE, you  may assume
  1874.           that your VBE driver has a serious bug.  In this case, you should
  1875.           also use the NOVESA switch when you install GRABBER in memory.)
  1876.  
  1877.           GRABBER(tm)      Documentation & Technical Notes    Page 36 of 39
  1878.  
  1879.  
  1880.  
  1881.           PROGRAMMERS NOTE:
  1882.           CALLING GRABBER FROM YOUR OWN PROGRAMS
  1883.           ---------------------------------------
  1884.  
  1885.           If you are  a programmer  developing your own  software, you  can
  1886.           invoke  GRABBER to capture the  screen from within  your own pro-
  1887.           gram, assuming that GRABBER is already resident in memory.
  1888.  
  1889.           This  is accomplished  by  using  GRABBER's external  programming
  1890.           hook,   which  is  really a  customized  call to  Interrupt  16h,
  1891.           described below.  You can write a routine to implement this  hook
  1892.           in  80x86  assembly language  or  in  any high-level  programming
  1893.           language which supports BIOS-level interrupt calls.
  1894.  
  1895.  
  1896.           CUSTOMIZED INTERRUPT 16H TO INVOKE GRABBER, SERVICE 4752H
  1897.           ---------------------------------------------------------
  1898.  
  1899.           On entry:   AX = 4752h
  1900.                          DL = 0    (to check only if GRABBER is resident)
  1901.                          DL = 1    (to capture the current screen)
  1902.  
  1903.           On return:  AX = 5247h   (if GRABBER is installed in memory)
  1904.  
  1905.                     For DL=0
  1906.                      or DL=1:   BL contains the logical drive to which
  1907.                                 the capture would be attempted (DL=0)
  1908.                                 or was attempted (DL=1).  0=default drive,
  1909.                                 1=drive A, 2=drive B, and so forth.
  1910.  
  1911.                     For DL=1:
  1912.  
  1913.                        No -->   Capture successful.  ES:DX points to
  1914.                     Carry       an ASCIIZ string which contains the
  1915.                      Flag       [drive:][\path\]filename of the newly
  1916.                                 created offspring (drive also coded in BL).
  1917.  
  1918.                     Carry -->   If DX = FFFFh, then a capture attempt
  1919.                      Flag       failed due to a critical disk error or
  1920.                       Set       disk-full error on the logical drive
  1921.                                 encoded in BL.  (Speaker beeped in either
  1922.                                 case.)
  1923.  
  1924.                                 If DX does not equal FFFFh, capture was
  1925.                                 not attempted.  GRABBER was busy servicing
  1926.                                 a prior capture request, or some other disk
  1927.                                 I/O was occurring, or DOS was not in a re-
  1928.                                 enterable state.  Try again momentarily.
  1929.  
  1930.           GRABBER(tm)      Documentation & Technical Notes    Page 37 of 39
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.           REPORTING PROBLEMS/BUGS
  1937.           ------------------------
  1938.  
  1939.           Please  let me  know if  GRABBER ever fails  to function  on your
  1940.           system as documented in these pages.
  1941.  
  1942.           Also,  if you  feel there is  an aspect  of the  program which is
  1943.           insufficiently  or unclearly  documented here, I  appreciate your
  1944.           suggestions.
  1945.  
  1946.           Please  read all  of the  documentation carefully  before putting
  1947.           GRABBER to  heavy use,  and before submitting  a problem  report.
  1948.           This way you can be certain whether there really is a problem, or
  1949.           whether the  program is being  put to a use  for which it  is not
  1950.           designed or intended.
  1951.  
  1952.           If you submit a problem report, please be as specific as possible
  1953.           about what happens and in what sequence or situation.  Be sure to
  1954.           list these specific things:  (1) all of the technical information
  1955.           provided on the screen after you enter the GRABBER command at the
  1956.           DOS prompt, with the program already resident in memory; (2) your
  1957.           brand and model  of PC; (3)  your brand and  version of DOS;  (4)
  1958.           your brand and  model of  video adapter and  display screen;  (5)
  1959.           what  software program you  are running when  the problem occurs;
  1960.           and  (6) the  contents of both  your CONFIG.SYS  and AUTOEXEC.BAT
  1961.           files.   It is difficult  to solve a  problem without having this
  1962.           information.
  1963.  
  1964.  
  1965.              By mail:    Gerald A. Monroe
  1966.                          P.O. Box 770906
  1967.                          Cleveland, Ohio 44107
  1968.                          U.S.A.
  1969.  
  1970.           CompuServe:    72321,1257
  1971.  
  1972.             Internet:    72321.1257@compuserve.com
  1973.  
  1974.                  Fax:    216/521-6060  (9 am to 5 pm Eastern time,
  1975.                                         Monday through Friday)
  1976.  
  1977.                           APPENDIX A  (KEY=kk hotkey codes)
  1978.                          -----------------------------------
  1979.  
  1980.           These  are the  codes  you may  use  with GRABBER's  and  GRTXT's
  1981.           "KEY=kk" parameter to change their hotkeys.  See also page 33 and
  1982.           Appendix B.
  1983.  
  1984.           Key  Code      Key  Code      Key    Code      Key           Code
  1985.           ---------      ---------      -----------      ------------------
  1986.            A    30        1    02        F1     59       Keypad plus    78
  1987.            B    48        2    03        F2     60       Keypad minus   74
  1988.            C    46        3    04        F3     61       Keypad 5       76
  1989.            D    32        4    05        F4     62       Print Screen   89
  1990.            E    18        5    06        F5     63       Backspace      14
  1991.            F    33        6    07        F6     64       Enter          28
  1992.            G    34        7    08        F7     65
  1993.            H    35        8    09        F8     66
  1994.            I    23        9    10        F9     67
  1995.            J    36        0    11       F10     68
  1996.            K    37                      F11     87
  1997.            L    38        `    41       F12     88
  1998.            M    50        -    12
  1999.            N    49        =    13       Tab     15
  2000.            O    24        ,    51       Esc     01
  2001.            P    25        .    52       Ins     82
  2002.            Q    16        /    53       Del     83
  2003.            R    19        ;    39       PgUp    73
  2004.            S    31        '    40       PgDn    81
  2005.            T    20        [    26       Home    71
  2006.            U    22        ]    27       End     79
  2007.            V    47        \    43        *      55
  2008.            W    17                      Up      72
  2009.            X    45                      Down    80
  2010.            Y    21                      Left    75
  2011.            Z    44                      Right   77
  2012.  
  2013.           NOTES:
  2014.  
  2015.           To view this table on your screen, enter GRABBER KEY=?
  2016.  
  2017.           The  asterisk key  (fifth from  the bottom  in the  third column)
  2018.           refers to the  <*> key which  is located next  to the  right-hand
  2019.           <Shift>  on 83-key PC and  PC/XT keyboards (which  is also marked
  2020.           "PrtSc"), and also to the <*> key which is located on the numeric
  2021.           keypad of 101-key PC/AT and PS/2 enhanced keyboards.
  2022.  
  2023.           The <Print Screen> key  (fourth entry in the last  column) refers
  2024.           to  the key which is  labeled "Print Screen"  on 101-key enhanced
  2025.           keyboards  only.  It does not refer  to the "PrtSc" key on 83-key
  2026.           keyboards. The  "Print Screen" key does not exist on non-enhanced
  2027.           keyboards.  Do not  specify  KEY=89 unless  your  keyboard has  a
  2028.           "Print Screen" key.
  2029.  
  2030.           <Up>,  <Down>,  <Left> and  <Right> at  the  bottom of  the third
  2031.           column represent the  arrow keys.  These codes refer to the arrow
  2032.           keys on  the numeric keypad on  all keyboards, as well  as to the
  2033.           separate arrow-key block on enhanced keyboards.
  2034.  
  2035.                          APPENDIX B  (SHIFT=ss hotkey codes)
  2036.                         -------------------------------------
  2037.  
  2038.           These  are the  codes  you may  use  with GRABBER's  and  GRTXT's
  2039.           "SHIFT=ss" parameter to change  their hotkeys.  See also  page 33
  2040.           and Appendix A.
  2041.  
  2042.                               Combination          Code
  2043.                              ---------------------------
  2044.                               No shift keys          00
  2045.                               Shift                  03
  2046.                               Ctrl                   04
  2047.                               Alt                    08
  2048.                               Alt + Shift            11
  2049.                               Ctrl + Shift           07
  2050.                               Ctrl + Alt             12
  2051.                               Ctrl + Alt + Shift     15
  2052.  
  2053.  
  2054.           NOTES:
  2055.  
  2056.           To view this table on your screen, enter GRABBER SHIFT=?
  2057.  
  2058.           If you wish to use a hotkey which does not include any of these
  2059.           shift keys (for example, <F10> or <Print Screen> alone), you may
  2060.           do so by specifying SHIFT=00 or no SHIFT= parameter at all. 
  2061.           However, it is recommended that you include some nonzero SHIFT=
  2062.           parameter to avoid probable keyboard conflicts between GRABBER
  2063.           and other software in your system.
  2064.  
  2065.           The exceptions to this are the <Esc> and <Enter> keys.  If you
  2066.           wish to use either of these in your GRABBER hotkey, then you must
  2067.           include some nonzero SHIFT= parameter.
  2068.  
  2069.           GRABBER does not distinguish between the left-hand and right-hand
  2070.           <Shift> keys, which are present on all keyboards.  Pressing the
  2071.           left <Shift> key has the same effect on GRABBER as pressing the
  2072.           right <Shift> key, and vice-versa.
  2073.  
  2074.           If you have an enhanced keyboard which has two <Ctrl> keys and
  2075.           two <Alt> keys, GRABBER treats the left and right members of each
  2076.           pair identically as well.
  2077.  
  2078.  
  2079.  
  2080.                               **  End of GRABBER.DOC  **
  2081.